# MerchantOps

> Documentation for the MerchantOps product catalog, enrichment, pricing, and publishing platform.

## Docs

- [Add Brand Alias](https://docs.merchantops.ai/api-reference/brands/add-brand-alias.md): Add an alias to a brand.
- [Add Brand Url](https://docs.merchantops.ai/api-reference/brands/add-brand-url.md): Add or update a country-specific URL for a brand.
- [Create Brand](https://docs.merchantops.ai/api-reference/brands/create-brand.md): Create a new brand manually.
- [Delete Brand](https://docs.merchantops.ai/api-reference/brands/delete-brand.md): Permanently delete a brand.
- [Get Brand](https://docs.merchantops.ai/api-reference/brands/get-brand.md): Get a brand by its key.
- [List Brands](https://docs.merchantops.ai/api-reference/brands/list-brands.md): List all brands with optional filtering.
- [List Brands Needing Review](https://docs.merchantops.ai/api-reference/brands/list-brands-needing-review.md): List brands that need URL review.
- [Resolve Url Conflict](https://docs.merchantops.ai/api-reference/brands/resolve-url-conflict.md): Resolve a URL conflict for a brand.
- [Search Brands](https://docs.merchantops.ai/api-reference/brands/search-brands.md): Search brands by name, aliases, or domain patterns.
- [Set Brand Scrape Mode](https://docs.merchantops.ai/api-reference/brands/set-brand-scrape-mode.md): Manually override a brand's scrape_mode (auto / enhanced / disabled).
- [Update Brand](https://docs.merchantops.ai/api-reference/brands/update-brand.md): Update a brand by key.
- [Verify Brand](https://docs.merchantops.ai/api-reference/brands/verify-brand.md): Mark a brand as verified.
- [Add Batch Records](https://docs.merchantops.ai/api-reference/catalog/add-batch-records.md)
- [Approve Catalog Batch](https://docs.merchantops.ai/api-reference/catalog/approve-catalog-batch.md)
- [Bulk Approve Records](https://docs.merchantops.ai/api-reference/catalog/bulk-approve-records.md)
- [Bulk Archive Catalog Batches](https://docs.merchantops.ai/api-reference/catalog/bulk-archive-catalog-batches.md): Archive catalog batches in bulk (status -> 'archived').
- [Bulk Delete Catalog Batches](https://docs.merchantops.ai/api-reference/catalog/bulk-delete-catalog-batches.md): Hard-delete catalog batches in bulk. Eligible: draft, cancelled, archived.
- [Bulk Reject Records](https://docs.merchantops.ai/api-reference/catalog/bulk-reject-records.md)
- [Cancel Catalog Batch](https://docs.merchantops.ai/api-reference/catalog/cancel-catalog-batch.md)
- [Create Catalog Batch](https://docs.merchantops.ai/api-reference/catalog/create-catalog-batch.md): Create a new draft catalog batch.
- [Delete Batch Record](https://docs.merchantops.ai/api-reference/catalog/delete-batch-record.md)
- [Delete Batch Records](https://docs.merchantops.ai/api-reference/catalog/delete-batch-records.md)
- [Delete Review Preferences](https://docs.merchantops.ai/api-reference/catalog/delete-review-preferences.md): Drop a type-specific override so the type falls back to the org default.
- [Get Catalog Batch](https://docs.merchantops.ai/api-reference/catalog/get-catalog-batch.md): Get a single catalog batch by key (org-scoped).
- [Get Record For Review](https://docs.merchantops.ai/api-reference/catalog/get-record-for-review.md): Bundle the record + full product properties + property metadata + relevant property definitions for the in-app review modal.
- [Get Review Preferences](https://docs.merchantops.ai/api-reference/catalog/get-review-preferences.md): Resolve the review config for ``product_type_key``.
- [List Batch Records](https://docs.merchantops.ai/api-reference/catalog/list-batch-records.md)
- [List Catalog Batches](https://docs.merchantops.ai/api-reference/catalog/list-catalog-batches.md): List catalog batches with filtering + sorting + pagination.
- [Patch Batch Record](https://docs.merchantops.ai/api-reference/catalog/patch-batch-record.md)
- [Patch Catalog Batch](https://docs.merchantops.ai/api-reference/catalog/patch-catalog-batch.md): Edit mutable fields on a draft batch (name, description, effective_date, target_key, target_env). Drafts edit everything; pending_approval edits only effective_date + notes. Cancelled batches are read-only.
- [Promote Catalog Batch](https://docs.merchantops.ai/api-reference/catalog/promote-catalog-batch.md): Promote a published batch to a different target environment.
- [Publish Catalog Batch Now](https://docs.merchantops.ai/api-reference/catalog/publish-catalog-batch-now.md): Trigger an immediate publish for an approved batch.
- [Set Review Preferences](https://docs.merchantops.ai/api-reference/catalog/set-review-preferences.md): Upsert the review-modal field configuration for a ProductType.
- [Submit Catalog Batch For Review](https://docs.merchantops.ai/api-reference/catalog/submit-catalog-batch-for-review.md)
- [Cancel Job](https://docs.merchantops.ai/api-reference/jobs/cancel-job.md): Cancel a running job.
- [Create Job](https://docs.merchantops.ai/api-reference/jobs/create-job.md): Create a new job for tracking batch operations.
- [Delete Job](https://docs.merchantops.ai/api-reference/jobs/delete-job.md): Delete a job (hard delete).
- [Get Job](https://docs.merchantops.ai/api-reference/jobs/get-job.md): Get detailed information about a specific job.
- [Get Job Facets](https://docs.merchantops.ai/api-reference/jobs/get-job-facets.md): Get distinct values for job filter dropdowns.
- [Get Job Statistics](https://docs.merchantops.ai/api-reference/jobs/get-job-statistics.md): Get aggregate statistics across all jobs.
- [Get Job Status](https://docs.merchantops.ai/api-reference/jobs/get-job-status.md): Get real-time status of a job (lightweight endpoint for polling).
- [List Jobs](https://docs.merchantops.ai/api-reference/jobs/list-jobs.md): List jobs with optional filtering and pagination.
- [Report Job Progress](https://docs.merchantops.ai/api-reference/jobs/report-job-progress.md): Worker progress update for a Job the caller created.
- [Approve Policy](https://docs.merchantops.ai/api-reference/map-pricing/approve-policy.md): Approve a MAP policy, its prices, and the source document.
- [Batch Archive Policies](https://docs.merchantops.ai/api-reference/map-pricing/batch-archive-policies.md): Batch archive MAP policies. Sets status to 'archived'.
- [Batch Delete Policies](https://docs.merchantops.ai/api-reference/map-pricing/batch-delete-policies.md): Batch delete MAP policies and all their prices. Products are NOT deleted.
- [Delete Policy](https://docs.merchantops.ai/api-reference/map-pricing/delete-policy.md): Delete a MAP policy and all its prices. Products are NOT deleted.
- [Get Active Policy For Brand](https://docs.merchantops.ai/api-reference/map-pricing/get-active-policy-for-brand.md): Get the currently active MAP policy for a brand.
- [Get Brand Parser Template](https://docs.merchantops.ai/api-reference/map-pricing/get-brand-parser-template.md): Get the brand parser template for a given brand.
- [Get Policy](https://docs.merchantops.ai/api-reference/map-pricing/get-policy.md): Get a single MAP policy by ID.
- [Get Policy Changes](https://docs.merchantops.ai/api-reference/map-pricing/get-policy-changes.md): Detect changes between this policy and the currently active policy for the same brand.
- [Get Price Detail](https://docs.merchantops.ai/api-reference/map-pricing/get-price-detail.md): Get a single MAP price by key.
- [List Policies](https://docs.merchantops.ai/api-reference/map-pricing/list-policies.md): List MAP policies with optional filtering by brand and status.
- [List Policy Prices](https://docs.merchantops.ai/api-reference/map-pricing/list-policy-prices.md): List MAP prices for a specific policy with optional search, filters, and change annotations.
- [Reject Policy](https://docs.merchantops.ai/api-reference/map-pricing/reject-policy.md): Reject a MAP policy with a reason.
- [Save Brand Parser Template](https://docs.merchantops.ai/api-reference/map-pricing/save-brand-parser-template.md): Save or update a brand parser template for MAP file ingestion.
- [Update Policy Status](https://docs.merchantops.ai/api-reference/map-pricing/update-policy-status.md): Update the status of a MAP policy (approved, rejected, executed).
- [Acknowledge Map Policy Changes](https://docs.merchantops.ai/api-reference/pricing/acknowledge-map-policy-changes.md): Mark all changes for the active MAP policy as acknowledged and create a snapshot.
- [Add Proposals To Batch](https://docs.merchantops.ai/api-reference/pricing/add-proposals-to-batch.md): Add proposals to a batch, creating price records from approved proposals.
- [Add Records By Brand](https://docs.merchantops.ai/api-reference/pricing/add-records-by-brand.md): Resolve "all latest active prices for these brands" into a republish batch. Same shape as add-records-by-product but scoped by brand_key — useful for "republish every Brooks price to VTEX QA" workflows.
- [Add Records By Product](https://docs.merchantops.ai/api-reference/pricing/add-records-by-product.md): Resolve "all latest active prices for these products" into a republish batch. ``price_types`` defaults to ``['msrp']`` since the VTEX worker handles partner resolution from MSRP. Pass explicit types to include MAP/Sale/etc.
- [Add Records By Variants](https://docs.merchantops.ai/api-reference/pricing/add-records-by-variants.md): Resolve "latest active prices for these specific variants" into a republish batch. Used by the product detail page's "Republish selected SKUs to…" flow.
- [Add Records To Batch](https://docs.merchantops.ai/api-reference/pricing/add-records-to-batch.md): Add existing price records to a batch.
- [Add Referenced Records](https://docs.merchantops.ai/api-reference/pricing/add-referenced-records.md): Append existing PriceRecord keys to a republish batch's ``referenced_record_keys`` list. Refuses if the batch's ``source_type`` is ``new_prices`` — use ``/add-records`` for that flow. Dedupes against the existing list; records belonging to a different org are silently skipped (returned in ``skipped_…
- [Approve Batch](https://docs.merchantops.ai/api-reference/pricing/approve-batch.md): Approve a price batch in PENDING_APPROVAL status.
- [Archive Comparison Run](https://docs.merchantops.ai/api-reference/pricing/archive-comparison-run.md): Archive or unarchive a comparison run and cascade to its proposals.
- [Batch Delete Records](https://docs.merchantops.ai/api-reference/pricing/batch-delete-records.md): Batch delete price records by keys or by product keys with temporal filter.
- [Batch Review Proposals](https://docs.merchantops.ai/api-reference/pricing/batch-review-proposals.md): Batch review multiple proposals with the same status.
- [Bulk Archive Price Batches](https://docs.merchantops.ai/api-reference/pricing/bulk-archive-price-batches.md): Archive price batches in bulk (status -> 'archived'). Per-key error codes returned in `details` for ineligible rows. Always 200.
- [Bulk Delete Price Batches](https://docs.merchantops.ai/api-reference/pricing/bulk-delete-price-batches.md): Hard-delete price batches in bulk.
- [Bulk Set Prices](https://docs.merchantops.ai/api-reference/pricing/bulk-set-prices.md): Create several prices at once for a set of variants.
- [Cancel Price Batch](https://docs.merchantops.ai/api-reference/pricing/cancel-price-batch.md): Cancel a price batch from any non-publishing status.
- [Create Batch](https://docs.merchantops.ai/api-reference/pricing/create-batch.md): Create a new price batch.
- [Create Batches From Preview](https://docs.merchantops.ai/api-reference/pricing/create-batches-from-preview.md): Create actual batch documents from a preview configuration and assign proposals.
- [Create Export Template](https://docs.merchantops.ai/api-reference/pricing/create-export-template.md): Create a new price export template.
- [Create Manual Proposal](https://docs.merchantops.ai/api-reference/pricing/create-manual-proposal.md): Create a manual price change proposal for a catalog colorway.
- [Create Or Update Override](https://docs.merchantops.ai/api-reference/pricing/create-or-update-override.md): Create or update a MAP policy override for a single field.
- [Create Price Record](https://docs.merchantops.ai/api-reference/pricing/create-price-record.md): Create a new price record.
- [Create Republish Batch From Variants](https://docs.merchantops.ai/api-reference/pricing/create-republish-batch-from-variants.md): Create a draft republish batch AND seed its ``referenced_record_keys`` from the selected variants in one round-trip. Saves the UI from chaining create → add-records-by-variants and avoids the empty-batch state that would block submit-for-review.
- [Delete Comparison Run](https://docs.merchantops.ai/api-reference/pricing/delete-comparison-run.md): Hard-delete a comparison run and cascade-delete its proposals.
- [Delete Export Template](https://docs.merchantops.ai/api-reference/pricing/delete-export-template.md): Delete an export template.
- [Delete Override](https://docs.merchantops.ai/api-reference/pricing/delete-override.md): Delete a MAP policy override by key.
- [Delete Price Batch](https://docs.merchantops.ai/api-reference/pricing/delete-price-batch.md): Delete a single price batch (and cascade its price records). Blocked when publishing_status is publishing/published/partial.
- [Delete Price Record](https://docs.merchantops.ai/api-reference/pricing/delete-price-record.md): Delete a price record.
- [Export Batch](https://docs.merchantops.ai/api-reference/pricing/export-batch.md): Mark a batch as exported with format and optional file URL.
- [Export Records](https://docs.merchantops.ai/api-reference/pricing/export-records.md): Export price records to Excel with custom column mapping.
- [Generate Batch Preview](https://docs.merchantops.ai/api-reference/pricing/generate-batch-preview.md): Generate a preview of proposed batches by grouping approved unbatched proposals by effective date.
- [Generate Export](https://docs.merchantops.ai/api-reference/pricing/generate-export.md): Generate and return an export file for a price batch.
- [Get Batch](https://docs.merchantops.ai/api-reference/pricing/get-batch.md): Get a single price batch by key.
- [Get Batch Grouping Preference](https://docs.merchantops.ai/api-reference/pricing/get-batch-grouping-preference.md): Get the batch grouping mode preference for the authenticated org.
- [Get Batch Publish Status](https://docs.merchantops.ai/api-reference/pricing/get-batch-publish-status.md): Return the publishing-pipeline state for a batch.
- [Get Batch Status](https://docs.merchantops.ai/api-reference/pricing/get-batch-status.md): Get batch processing status for polling.
- [Get Comparison Run](https://docs.merchantops.ai/api-reference/pricing/get-comparison-run.md): Get comparison run status and summary.
- [Get Comparison Summary](https://docs.merchantops.ai/api-reference/pricing/get-comparison-summary.md): Get aggregated status counts for a comparison run.
- [Get Export Fields](https://docs.merchantops.ai/api-reference/pricing/get-export-fields.md): Return the list of available fields for pricing exports.
- [Get Export Template](https://docs.merchantops.ai/api-reference/pricing/get-export-template.md): Get a single export template by key.
- [Get Import Template](https://docs.merchantops.ai/api-reference/pricing/get-import-template.md): Download a CSV template for price imports.
- [Get Import Upload Url](https://docs.merchantops.ai/api-reference/pricing/get-import-upload-url.md): Generate a presigned GCS upload URL for a CSV price import file.
- [Get Map Policy Brand View](https://docs.merchantops.ai/api-reference/pricing/get-map-policy-brand-view.md): Return full merged MAP policy view for a brand.
- [Get Map Policy Brands](https://docs.merchantops.ai/api-reference/pricing/get-map-policy-brands.md): Return list of brands that have MAP policies.
- [Get Map Policy Changes](https://docs.merchantops.ai/api-reference/pricing/get-map-policy-changes.md): Return unacknowledged changes for the active MAP policy of a brand.
- [Get Price Record](https://docs.merchantops.ai/api-reference/pricing/get-price-record.md): Get a single price record by key.
- [Get Price Records By Product](https://docs.merchantops.ai/api-reference/pricing/get-price-records-by-product.md): Get all price records for a specific product.
- [Get Product Summary](https://docs.merchantops.ai/api-reference/pricing/get-product-summary.md): Return a product list enriched with price record statistics.
- [Get Proposal](https://docs.merchantops.ai/api-reference/pricing/get-proposal.md): Get a single price change proposal by key.
- [Get Proposal Variants](https://docs.merchantops.ai/api-reference/pricing/get-proposal-variants.md): Get variant coverage for a style-color level proposal.
- [Get Proposals Status Summary](https://docs.merchantops.ai/api-reference/pricing/get-proposals-status-summary.md): Get status counts for proposals in a comparison run.
- [Get Record Facet Values](https://docs.merchantops.ai/api-reference/pricing/get-record-facet-values.md): Get distinct values for a field to populate filter dropdowns.
- [Get Unpriced Colorways](https://docs.merchantops.ai/api-reference/pricing/get-unpriced-colorways.md): Find catalog colorways that have no matching proposal in this run.
- [Get Upcoming Batches](https://docs.merchantops.ai/api-reference/pricing/get-upcoming-batches.md): Get batches with due dates within the specified number of days.
- [Import Prices Async](https://docs.merchantops.ai/api-reference/pricing/import-prices-async.md): Start an async price import from a CSV file in GCS.
- [Link Lakehouse Price](https://docs.merchantops.ai/api-reference/pricing/link-lakehouse-price.md): Link a historical MAP price to a catalog-only colorway.
- [Link Proposal Variants](https://docs.merchantops.ai/api-reference/pricing/link-proposal-variants.md): Manually link variant keys to a style-color proposal.
- [List Batch Records](https://docs.merchantops.ai/api-reference/pricing/list-batch-records.md): Return ALL price records associated with a batch (any status).
- [List Batches](https://docs.merchantops.ai/api-reference/pricing/list-batches.md): List price batches with filtering + sorting + pagination.
- [List Comparison Run Summaries](https://docs.merchantops.ai/api-reference/pricing/list-comparison-run-summaries.md): List comparison runs enriched with MapPolicy metadata and proposal status counts.
- [List Comparison Runs](https://docs.merchantops.ai/api-reference/pricing/list-comparison-runs.md): List comparison runs with optional filtering and pagination.
- [List Export Templates](https://docs.merchantops.ai/api-reference/pricing/list-export-templates.md): List price export templates with optional filtering.
- [List Price Records](https://docs.merchantops.ai/api-reference/pricing/list-price-records.md): List price records with optional filtering and pagination.
- [List Proposals](https://docs.merchantops.ai/api-reference/pricing/list-proposals.md): List price change proposals with optional filtering, search, and pagination.
- [List Records Grouped By Product](https://docs.merchantops.ai/api-reference/pricing/list-records-grouped-by-product.md): List price records aggregated at the product level with summary statistics.
- [Mass Create Price Records](https://docs.merchantops.ai/api-reference/pricing/mass-create-price-records.md): Mass create price records for multiple variants of a product.
- [Override Proposal Match Status](https://docs.merchantops.ai/api-reference/pricing/override-proposal-match-status.md): Override the match status on a proposal.
- [Preview Fan Out](https://docs.merchantops.ai/api-reference/pricing/preview-fan-out.md): Preview how style-color proposals will fan out to variant-level records.
- [Publish Batch Now](https://docs.merchantops.ai/api-reference/pricing/publish-batch-now.md): Manually trigger publishing for an approved batch, bypassing the effective_date gate. Useful for testing and emergency repricing.
- [Refresh Map Policy Changes](https://docs.merchantops.ai/api-reference/pricing/refresh-map-policy-changes.md): Re-trigger change detection for the active MAP policy of a brand.
- [Reject Batch](https://docs.merchantops.ai/api-reference/pricing/reject-batch.md): Reject a price batch and delete its draft records.
- [Review Proposal](https://docs.merchantops.ai/api-reference/pricing/review-proposal.md): Review a single price change proposal (approve, reject, or modify).
- [Run Comparison From Map Policy](https://docs.merchantops.ai/api-reference/pricing/run-comparison-from-map-policy.md): Run price comparison using the active customer MAP policy snapshot.
- [Search Lakehouse Prices](https://docs.merchantops.ai/api-reference/pricing/search-lakehouse-prices.md): Search historical MAP policy versions for colorways matching a style.
- [Set Batch Grouping Preference](https://docs.merchantops.ai/api-reference/pricing/set-batch-grouping-preference.md): Set the batch grouping mode preference for the authenticated org.
- [Submit Price Batch For Review](https://docs.merchantops.ai/api-reference/pricing/submit-price-batch-for-review.md): Move a draft price batch to PENDING_APPROVAL.
- [Trigger Comparison](https://docs.merchantops.ai/api-reference/pricing/trigger-comparison.md): Trigger a new comparison run between a MAP policy and catalog prices.
- [Update Batch](https://docs.merchantops.ai/api-reference/pricing/update-batch.md): Update a price batch.
- [Update Export Template](https://docs.merchantops.ai/api-reference/pricing/update-export-template.md): Update an export template.
- [Update Price Record](https://docs.merchantops.ai/api-reference/pricing/update-price-record.md): Update a price record.
- [Batch Delete Lakehouse Products](https://docs.merchantops.ai/api-reference/product-lakehouse/batch-delete-lakehouse-products.md): Delete multiple lakehouse products in a single batch operation.
- [Confirm Column Mapping](https://docs.merchantops.ai/api-reference/product-lakehouse/confirm-column-mapping.md): Confirm or edit the column mapping for a document (Phase 7 HITL).
- [Delete Brand Technology](https://docs.merchantops.ai/api-reference/product-lakehouse/delete-brand-technology.md): Delete a brand technology.
- [Delete Document](https://docs.merchantops.ai/api-reference/product-lakehouse/delete-document.md): Delete a document and associated lakehouse products. Requires: document:delete permission.
- [Delete Lakehouse Product](https://docs.merchantops.ai/api-reference/product-lakehouse/delete-lakehouse-product.md): Delete a lakehouse product. Requires: lakehouse:write permission.
- [Generate Upload Urls](https://docs.merchantops.ai/api-reference/product-lakehouse/generate-upload-urls.md): Generate presigned upload URLs for document files. Creates document_metadata records and returns presigned URLs for browser upload. Requires: lakehouse:upload permission
- [Get Brand Technology](https://docs.merchantops.ai/api-reference/product-lakehouse/get-brand-technology.md): Get a single brand technology by key.
- [Get Column Mapping](https://docs.merchantops.ai/api-reference/product-lakehouse/get-column-mapping.md): Get the column mapping for a document (Phase 7 HITL).
- [Get Document](https://docs.merchantops.ai/api-reference/product-lakehouse/get-document.md): Get document metadata by ID with lakehouse extraction data. Requires: document:read permission.
- [Get Lakehouse Product](https://docs.merchantops.ai/api-reference/product-lakehouse/get-lakehouse-product.md): Get a single lakehouse product by key. Requires: lakehouse:read permission.
- [Get Lakehouse Products Facets](https://docs.merchantops.ai/api-reference/product-lakehouse/get-lakehouse-products-facets.md): Get distinct values for filter dropdowns (facets).
- [Get Mapping Fields](https://docs.merchantops.ai/api-reference/product-lakehouse/get-mapping-fields.md): Return the combined field list for the product HITL mapping dialog.
- [Get Product Preview](https://docs.merchantops.ai/api-reference/product-lakehouse/get-product-preview.md): Get a preview of products extracted from a document (Phase 7 HITL).
- [Get Technology Source Url](https://docs.merchantops.ai/api-reference/product-lakehouse/get-technology-source-url.md): Generate a signed download URL for the technology's source document.
- [Ingest Documents](https://docs.merchantops.ai/api-reference/product-lakehouse/ingest-documents.md): Start document ingestion process. Publishes DocumentUploadedEvents to NATS for each document. Requires: lakehouse:upload permission
- [List Brand Technologies](https://docs.merchantops.ai/api-reference/product-lakehouse/list-brand-technologies.md): List brand technologies with filtering and pagination.
- [List Documents](https://docs.merchantops.ai/api-reference/product-lakehouse/list-documents.md): List document metadata with filtering and pagination. Requires: document:read permission.
- [List Lakehouse Products](https://docs.merchantops.ai/api-reference/product-lakehouse/list-lakehouse-products.md): List lakehouse products with filtering and pagination.
- [Preview Transform](https://docs.merchantops.ai/api-reference/product-lakehouse/preview-transform.md): Preview the result of applying field rules to sample data.
- [Reject Column Mapping](https://docs.merchantops.ai/api-reference/product-lakehouse/reject-column-mapping.md): Reject the column mapping for a document (Phase 7 HITL).
- [Update Brand Technology](https://docs.merchantops.ai/api-reference/product-lakehouse/update-brand-technology.md): Update a brand technology.
- [Update Lakehouse Product](https://docs.merchantops.ai/api-reference/product-lakehouse/update-lakehouse-product.md): Update a lakehouse product. Requires: lakehouse:write permission.
- [Validate Column Mapping](https://docs.merchantops.ai/api-reference/product-lakehouse/validate-column-mapping.md): One-shot LLM validation of a proposed column mapping.
- [Create a product type category](https://docs.merchantops.ai/api-reference/product-type-categories/create-a-product-type-category.md): Create a new product type category.
- [Delete a product type category](https://docs.merchantops.ai/api-reference/product-type-categories/delete-a-product-type-category.md): Delete a product type category.
- [List all product type categories](https://docs.merchantops.ai/api-reference/product-type-categories/list-all-product-type-categories.md): List all product type categories for the organization, sorted by display_order.
- [List enrichment overrides for a category](https://docs.merchantops.ai/api-reference/product-type-categories/list-enrichment-overrides-for-a-category.md): List all enrichment overrides for a category.
- [Remove category enrichment override for a property](https://docs.merchantops.ai/api-reference/product-type-categories/remove-category-enrichment-override-for-a-property.md): Remove a category-level enrichment config override, reverting to PropertyDefinition default.
- [Set category enrichment override for a property](https://docs.merchantops.ai/api-reference/product-type-categories/set-category-enrichment-override-for-a-property.md): Set or update a category-level enrichment config override for a property.
- [Update a product type category](https://docs.merchantops.ai/api-reference/product-type-categories/update-a-product-type-category.md): Update a product type category.
- [Batch Delete Product Types](https://docs.merchantops.ai/api-reference/product-types/batch-delete-product-types.md): Delete multiple product types by their keys in a single batch operation.
- [Create Product Type](https://docs.merchantops.ai/api-reference/product-types/create-product-type.md): Create a new ProductType.
- [Delete Product Type](https://docs.merchantops.ai/api-reference/product-types/delete-product-type.md): Delete a ProductType (soft delete by default, marks inactive).
- [Export Product Type Properties Csv](https://docs.merchantops.ai/api-reference/product-types/export-product-type-properties-csv.md): Export per-ProductType property references as a long-format CSV.
- [Export Product Types Csv](https://docs.merchantops.ai/api-reference/product-types/export-product-types-csv.md): Export product types as CSV.
- [Get Product Type](https://docs.merchantops.ai/api-reference/product-types/get-product-type.md): Get a single ProductType by its key.
- [Get Product Type Count](https://docs.merchantops.ai/api-reference/product-types/get-product-type-count.md): Get count of product types matching filters.
- [Get Product Type With Attributes](https://docs.merchantops.ai/api-reference/product-types/get-product-type-with-attributes.md): Get a ProductType with its PropertyDefinitions resolved.
- [Get Product Type With Properties](https://docs.merchantops.ai/api-reference/product-types/get-product-type-with-properties.md): Get a ProductType with its effective PropertyDefinitions resolved.
- [List Product Types](https://docs.merchantops.ai/api-reference/product-types/list-product-types.md): List ProductTypes with optional filtering and pagination.
- [Reset enrichment config to property default](https://docs.merchantops.ai/api-reference/product-types/reset-enrichment-config-to-property-default.md): Remove enrichment config override, reverting to PropertyDefinition default.
- [Search Product Types](https://docs.merchantops.ai/api-reference/product-types/search-product-types.md): Search ProductTypes using type-ahead functionality.
- [Set enrichment config override for a property](https://docs.merchantops.ai/api-reference/product-types/set-enrichment-config-override-for-a-property.md): Set or update enrichment config override for a property on a product type.
- [Update Product Type](https://docs.merchantops.ai/api-reference/product-types/update-product-type.md): Update a ProductType.
- [Upload Product Type Properties Csv](https://docs.merchantops.ai/api-reference/product-types/upload-product-type-properties-csv.md): Upload properties for product types from CSV content.
- [Upload Product Types Csv](https://docs.merchantops.ai/api-reference/product-types/upload-product-types-csv.md): Upload product types from CSV content.
- [Batch Delete Products](https://docs.merchantops.ai/api-reference/products/batch-delete-products.md): Delete ALL versions of multiple products by their keys in a single batch operation.
- [Batch Delete Products Async](https://docs.merchantops.ai/api-reference/products/batch-delete-products-async.md): Queue a large bulk delete. Creates a BULK_DELETE Job and publishes a ``bulkops.delete`` message; the bulkops-worker deletes all versions in chunks (cascading variants) and tracks progress on the job.
- [Batch Enrich Products](https://docs.merchantops.ai/api-reference/products/batch-enrich-products.md): Trigger enrichment for multiple products.
- [Create Product](https://docs.merchantops.ai/api-reference/products/create-product.md): Create a new Product with automatic NATS event publishing.
- [Create Product Version](https://docs.merchantops.ai/api-reference/products/create-product-version.md): Create a new version of a product.
- [Create Products Batch](https://docs.merchantops.ai/api-reference/products/create-products-batch.md): Create multiple products in batches.
- [Delete All Product Versions](https://docs.merchantops.ai/api-reference/products/delete-all-product-versions.md): Delete ALL versions of a Product by key.
- [Delete Product](https://docs.merchantops.ai/api-reference/products/delete-product.md): Delete a Product (soft delete by default, unpublishes the product).
- [Delete Product Version](https://docs.merchantops.ai/api-reference/products/delete-product-version.md): Delete a specific product version.
- [Enrich Product Version](https://docs.merchantops.ai/api-reference/products/enrich-product-version.md): Trigger enrichment for an existing product version.
- [Export Products](https://docs.merchantops.ai/api-reference/products/export-products.md): Export products to Excel/CSV with custom column mapping (synchronous).
- [Export Products Async](https://docs.merchantops.ai/api-reference/products/export-products-async.md): Queue a large product export. Creates an EXPORT Job and publishes a ``bulkops.export`` message; the bulkops-worker resolves the products, builds the file, uploads it to GCS, and records the file URL on the job.
- [Get Crawl Discoveries](https://docs.merchantops.ai/api-reference/products/get-crawl-discoveries.md): Get crawl discoveries for a job.
- [Get Export Download Url](https://docs.merchantops.ai/api-reference/products/get-export-download-url.md): Mint a fresh signed download URL for a completed export job.
- [Get Export Fields](https://docs.merchantops.ai/api-reference/products/get-export-fields.md): Get available export fields for a set of products or product types.
- [Get Import Upload Url](https://docs.merchantops.ai/api-reference/products/get-import-upload-url.md): Generate a presigned GCS upload URL for a JSON import file.
- [Get Product](https://docs.merchantops.ai/api-reference/products/get-product.md): Get a single Product by key (latest version by default).
- [Get Product Count](https://docs.merchantops.ai/api-reference/products/get-product-count.md): Get count of products matching filters.
- [Get Product Facets](https://docs.merchantops.ai/api-reference/products/get-product-facets.md): Return facet values for product filters.
- [Get Product Versions](https://docs.merchantops.ai/api-reference/products/get-product-versions.md): Get all versions of a product.
- [Get Publish History](https://docs.merchantops.ai/api-reference/products/get-publish-history.md): Per-version publish history for a product, derived from ``catalog_publish_records`` (each record pins ``product_version`` and carries ``publish_outcomes[target_key][env]``).
- [Import From Crawl](https://docs.merchantops.ai/api-reference/products/import-from-crawl.md): Import selected URLs from crawl discoveries as products.
- [Import Json](https://docs.merchantops.ai/api-reference/products/import-json.md): Import products from JSON.
- [Import Json Async](https://docs.merchantops.ai/api-reference/products/import-json-async.md): Start an async product import from a JSON file in GCS.
- [List Product Keys](https://docs.merchantops.ai/api-reference/products/list-product-keys.md): Return up to ``PRODUCT_KEYS_HARD_CAP`` product keys matching the given filters.
- [List Products](https://docs.merchantops.ai/api-reference/products/list-products.md): List Products with optional filtering, sorting, and pagination.
- [Queue Product From Url](https://docs.merchantops.ai/api-reference/products/queue-product-from-url.md): Queue a product for enrichment from a product page URL.
- [Queue Site Crawl](https://docs.merchantops.ai/api-reference/products/queue-site-crawl.md): Queue a site crawl job for batch product discovery.
- [Search Products](https://docs.merchantops.ai/api-reference/products/search-products.md): Search Products using type-ahead functionality.
- [Select All Product Pages](https://docs.merchantops.ai/api-reference/products/select-all-product-pages.md): Select all product pages with confidence above threshold.
- [Submit Feedback](https://docs.merchantops.ai/api-reference/products/submit-feedback.md): Submit user feedback (thumbs up/down) on product enrichment quality.
- [Update Crawl Discovery Selection](https://docs.merchantops.ai/api-reference/products/update-crawl-discovery-selection.md): Update the selection status of a crawl discovery.
- [Update Product](https://docs.merchantops.ai/api-reference/products/update-product.md): Update a Product.
- [Update Version Labels](https://docs.merchantops.ai/api-reference/products/update-version-labels.md): Update labels on a product version.
- [Upload Base Products Csv](https://docs.merchantops.ai/api-reference/products/upload-base-products-csv.md): Upload base products from CSV.
- [Upload Csv](https://docs.merchantops.ai/api-reference/products/upload-csv.md): Create products from CSV content.
- [Add Property Definition Value](https://docs.merchantops.ai/api-reference/property-definitions/add-property-definition-value.md): Add a new value to an enum-type property definition.
- [Batch Delete Property Definitions](https://docs.merchantops.ai/api-reference/property-definitions/batch-delete-property-definitions.md): Batch soft delete multiple property definitions.
- [Bulk Update Property Flags](https://docs.merchantops.ai/api-reference/property-definitions/bulk-update-property-flags.md): Apply visibility / isFacetable / isSearchable across many definitions.
- [Create Property Definition](https://docs.merchantops.ai/api-reference/property-definitions/create-property-definition.md): Create a new PropertyDefinition.
- [Delete Property Definition](https://docs.merchantops.ai/api-reference/property-definitions/delete-property-definition.md): Delete a PropertyDefinition (soft delete by default, marks inactive).
- [Export Property Definitions Csv](https://docs.merchantops.ai/api-reference/property-definitions/export-property-definitions-csv.md): Export property definitions as CSV.
- [Export Property Overrides Csv](https://docs.merchantops.ai/api-reference/property-definitions/export-property-overrides-csv.md): Export every enrichment override (per-ProductType + per-Category) as CSV.
- [Export Property Values Csv](https://docs.merchantops.ai/api-reference/property-definitions/export-property-values-csv.md): Export property values for enum / localized_enum properties as CSV.
- [Get all product-type enrichment overrides for a property](https://docs.merchantops.ai/api-reference/property-definitions/get-all-product-type-enrichment-overrides-for-a-property.md): Get all enrichment config overrides for a property (product-type and category levels).
- [Get Property Definition](https://docs.merchantops.ai/api-reference/property-definitions/get-property-definition.md): Get a single PropertyDefinition by key.
- [List Property Definitions](https://docs.merchantops.ai/api-reference/property-definitions/list-property-definitions.md): List PropertyDefinitions with optional filtering and pagination.
- [Search Property Definitions](https://docs.merchantops.ai/api-reference/property-definitions/search-property-definitions.md): Search PropertyDefinitions using Atlas Search with regex fallback.
- [Update Property Definition](https://docs.merchantops.ai/api-reference/property-definitions/update-property-definition.md): Update an existing PropertyDefinition.
- [Upload Property Definitions Csv](https://docs.merchantops.ai/api-reference/property-definitions/upload-property-definitions-csv.md): Upload property definitions from CSV content.
- [Upload Property Overrides Csv](https://docs.merchantops.ai/api-reference/property-definitions/upload-property-overrides-csv.md): Upload per-ProductType OR per-Category enrichment overrides from CSV.
- [Upload Property Values Csv](https://docs.merchantops.ai/api-reference/property-definitions/upload-property-values-csv.md): Upload property values from CSV content.
- [Batch Delete Variants](https://docs.merchantops.ai/api-reference/variants/batch-delete-variants.md): Batch hard delete Variants by keys.
- [Bulk Update Variants](https://docs.merchantops.ai/api-reference/variants/bulk-update-variants.md): Apply ``properties`` to every variant in ``variant_keys`` (mass update).
- [Confirm Matrix](https://docs.merchantops.ai/api-reference/variants/confirm-matrix.md): Persist previously previewed variants from matrix generation.
- [Create Variant](https://docs.merchantops.ai/api-reference/variants/create-variant.md): Create a new Variant for a product.
- [Delete Variant](https://docs.merchantops.ai/api-reference/variants/delete-variant.md): Hard delete a Variant.
- [Generate Matrix](https://docs.merchantops.ai/api-reference/variants/generate-matrix.md): Generate a variant matrix preview without persisting.
- [Get Variant](https://docs.merchantops.ai/api-reference/variants/get-variant.md): Get a single Variant by key.
- [Get Variant Facets](https://docs.merchantops.ai/api-reference/variants/get-variant-facets.md): Facets for the variants of a single product.
- [List Variants](https://docs.merchantops.ai/api-reference/variants/list-variants.md): List Variants for a product with pagination, sorting, and property filters.
- [Search Variants](https://docs.merchantops.ai/api-reference/variants/search-variants.md): Search variants for a product by key or display properties (color, size, width).
- [Update Variant](https://docs.merchantops.ai/api-reference/variants/update-variant.md): Update a Variant's properties.
- [Upload Variants Csv](https://docs.merchantops.ai/api-reference/variants/upload-variants-csv.md): Upload variants from CSV for a product.
- [Brands](https://docs.merchantops.ai/catalog/brands.md): Brand identity as shared reference data, and how products reference it.
- [Display groups & labels](https://docs.merchantops.ai/catalog/display-groups-labels.md): Organize properties into sections and tag product versions for tracking.
- [Product types & properties](https://docs.merchantops.ai/catalog/product-types-properties.md): Templates and the attribute schema that define what your products can hold.
- [Products & variants](https://docs.merchantops.ai/catalog/products-variants.md): How products and their buyable variants are modeled in MerchantOps.
- [Versioning](https://docs.merchantops.ai/catalog/versioning.md): How products are versioned, why enrichment adds versions, and which one holds the richest data.
- [Import connectors](https://docs.merchantops.ai/data-ingestion/import-connectors.md): Scheduled, automated feeds that import a partner or ERP catalog on a schedule.
- [The Lakehouse](https://docs.merchantops.ai/data-ingestion/lakehouse.md): A shared knowledge base of product, technology, and document data that enrichment draws on.
- [Data ingestion overview](https://docs.merchantops.ai/data-ingestion/overview.md): The ways product data gets into MerchantOps, from the dashboard to the API.
- [Uploading products](https://docs.merchantops.ai/data-ingestion/uploading-products.md): Bulk-import products from a CSV: column mapping, batches, and job tracking.
- [How enrichment works](https://docs.merchantops.ai/enrichment/how-it-works.md): How MerchantOps automatically fills in and standardizes your product data, and how it merges sources by priority.
- [Reviewing enriched products](https://docs.merchantops.ai/enrichment/reviewing-results.md): How to check enrichment status and completeness, re-run enrichment, and why your own values are protected.
- [Core concepts](https://docs.merchantops.ai/getting-started/concepts.md): The vocabulary of MerchantOps — products, variants, types, the lakehouse, jobs, and enrichment.
- [Quickstart](https://docs.merchantops.ai/getting-started/quickstart.md): From sign-in to your first enriched product.
- [MerchantOps](https://docs.merchantops.ai/index.md): Enrich, price, and publish your product catalog — with agents and APIs built in.
- [Jobs](https://docs.merchantops.ai/jobs/overview.md): How MerchantOps tracks batch operations — import, enrichment, and export — and how to monitor their progress.
- [Comparison & proposals](https://docs.merchantops.ai/pricing/comparison-proposals.md): Compare a MAP policy against your catalog prices and review the resulting price-change proposals.
- [Export](https://docs.merchantops.ai/pricing/export.md): Export prices to a spreadsheet with selectable fields, custom column mappings, and reusable templates.
- [MAP policies](https://docs.merchantops.ai/pricing/map-policies.md): Minimum Advertised Price policies as legal/compliance data, with per-organization sharing off by default.
- [Price batches](https://docs.merchantops.ai/pricing/price-batches.md): Group price changes into batches, review and approve them, and publish on an effective date.
- [Price records](https://docs.merchantops.ai/pricing/price-records.md): How MerchantOps stores prices — per-variant records with a price type and effective date.
- [Build your own connector](https://docs.merchantops.ai/publishing/connectors.md): Run your own publishing target: poll MerchantOps for approved records and report outcomes over a pull-based API.
- [Publishing overview](https://docs.merchantops.ai/publishing/overview.md): How MerchantOps publishes approved catalog and pricing changes to your storefront and other targets.
- [Reading publish status](https://docs.merchantops.ai/publishing/publish-status.md): Interpret draft / live / changed status, per-target chips, and per-environment publish outcomes.
- [VTEX (reference connector)](https://docs.merchantops.ai/publishing/vtex.md): How MerchantOps publishes catalog and pricing to VTEX — one example of a publishing connector.
- [Content settings](https://docs.merchantops.ai/settings/content-settings.md): Set the tone, structure, and guardrails MerchantOps uses when it generates product content.
- [Lakehouse sharing](https://docs.merchantops.ai/settings/lakehouse-sharing.md): Control whether your products, technologies, and MAP policies are shared across organizations.
- [Publishing settings](https://docs.merchantops.ai/settings/publishing-settings.md): Register publishing targets, enable multiple environments, and configure per-target options.
- [Team & roles](https://docs.merchantops.ai/settings/team-and-roles.md): Invite members, assign roles, and manage who can do what in your organization.
- [CLI (`mo`)](https://docs.merchantops.ai/tools/cli.md): A command-line client for the MerchantOps API, authenticated with OAuth.
- [Connect the MCP server](https://docs.merchantops.ai/tools/mcp.md): Give Claude read-only access to your MerchantOps catalog over OAuth.
- [Agents & Tools](https://docs.merchantops.ai/tools/overview.md): Drive MerchantOps from Claude, the command line, or your own code.
- [Skills](https://docs.merchantops.ai/tools/skills.md): Packaged catalog-setup workflows for Claude.

## OpenAPI Specs

- [merchantops-public](https://docs.merchantops.ai/openapi/merchantops-public.json)