1. MerchantCatalog
OrderMesh STG
  • Introduction to our API
    • Getting Started
    • Product Catalog
    • Webhooks Overview
    • Merchant Notifications Guide
  • User
    • Client
      • Generate Service Client Access Token
    • User
      • Login User by Username and Password
      • Login User with Refresh Token
    • Schemas
      • AssignUserRoleDto
      • BulkResponse
      • BulkResponseItem
      • ClientTokenResponseDTO
      • ConflictErrorResponse
      • CreateInvitationDto
      • CreateInvitationDtoBulkModel
      • CreateInvitationResponse
      • CreateRoleDTO
      • CreateServiceClientDto
      • CreateServiceClientResponseDTO
      • CreateUserDto
      • CreateVendorInvitationDto
      • CreateVendorInvitationDtoBulkModel
      • CreateVendorInvitationResponse
      • DeleteInvitationResponse
      • DeleteVendorInvitationResponse
      • Error
      • ExternalErrorResponse
      • ForbiddenErrorResponse
      • ForgotPasswordDTO
      • FutureAssociationsDTO
      • GetInvitationResponse
      • GetInvitationsByMerchantIdResponse
      • GetInvitationsByMerchantIdResponseDto
      • GetServiceClientTokenDto
      • GetVendorInvitationResponse
      • GetVendorInvitationsByVendorIdResponse
      • GetVendorInvitationsByVendorIdResponseDto
      • InvitationDeliveryMethodEnum
      • InvitationDeliveryResponse
      • InvitationStatusEnum
      • InvitationsByMerchantIdSortByEnum
      • LoginUserDto
      • LoginUserWithAuthorizationCode
      • LoginUserWithRefreshToken
      • NotFoundErrorResponse
      • OnboardUserDto
      • PasswordPolicyDTO
      • PatchUserDTO
      • PermissionDTO
      • PermissionSet
      • PermissionSetsRequestDTO
      • PermissionSetsResponseDTO
      • ResendInvitationResponse
      • ResendVendorInvitationResponse
      • ResetPasswordDTO
      • ResourceDTO
      • RoleDTO
      • RolePermissionDTO
      • RoleWithPermissionDTO
      • SearchRolesEnum
      • SearchRolesResponseDTO
      • SearchUsersEnum
      • SearchUsersResponseDTO
      • ServiceClientResponseDTO
      • StringBulkModel
      • TokenResponseDTO
      • UnassignUserRoleDTO
      • UnauthorizedErrorResponse
      • UnauthorizedResult
      • UnhandledErrorResponse
      • UpdateAssociationTypeDTO
      • UpdateAttributesDto
      • UpdateRoleDTO
      • UpdateRolePermissionsDTO
      • UserResponseDTO
      • ValidateEmailsResponse
      • ValidationErrorResponse
      • ValidationResponseDTO
  • Order
    • OrderItems
      • Search for order items based on various criteria and filters
    • Orders
      • Create a New Order.
      • Search for orders based on various criteria and filters.
      • Create multiple orders
      • Retrieve multiple orders
      • Update multiple orders
      • Retrieve a list of orders
      • Retrieve an order by Order ID.
      • Update order data.
      • Retrieve an order by Safe ID
      • Retrieve order item by Order Item ID
      • Update an item within an order.
      • Cancel Order or order items
      • Change the order status to Customer Care Hold
      • Retrieve audit logs for a specific order.
      • Retrieve audit logs for a specific order.
      • Retrieve audit logs for a specific order item.
      • Add a Refund Request.
    • Schemas
      • APIClientInfoModel
      • AddRefundItemModel
      • AddRefundModel
      • AddressModel
      • AttributeModel
      • BaseAddressModel
      • BillingInfoModel
      • BulkResponse
      • BulkResponseItem
      • CancelOrderItemModel
      • CancelOrderModel
      • CancelOrderResponse
      • ConflictErrorResponse
      • CoordinatesModel
      • CreateOrderCustomerPaymentMethodModel
      • CreateOrderCustomerTransactionModel
      • CreateOrderItemImageModel
      • CreateOrderItemModel
      • CreateOrderModel
      • CreateOrderModelBulkModel
      • CreateOrderResponse
      • CustomerCareHoldOrderResponse
      • Error
      • ForbiddenErrorResponse
      • GetAuditLogResponse
      • GetOrderCustomerPaymentMethodModel
      • GetOrderCustomerTransactionModel
      • GetOrderItemImageModel
      • GetOrderItemModel
      • GetOrderItemRefundDataItemModel
      • GetOrderItemRefundDataModel
      • GetOrderItemResponse
      • GetOrderModel
      • GetOrderResponse
      • GetOrdersCountByStatusResponse
      • GetOrdersPollingStoppedCountResponse
      • ListOrderModel
      • ListOrdersResponse
      • NotFoundErrorResponse
      • OptionModel
      • OrderItemStatus
      • OrderStatus
      • OrdersCountByStatus
      • PriceModel
      • RefreshProcessingModel
      • RefreshProcessingResponse
      • ReprintCostCoverageModel
      • ReprintModel
      • ReprintShipmentItemModel
      • ReprintShipmentModel
      • ResourceFormat
      • SearchOrderItemsResponse
      • SearchOrderModel
      • SearchOrdersResponse
      • ShipmentMetadata
      • StartProcessingModel
      • StartProcessingResponse
      • StringAuditEvent
      • UnauthorizedResult
      • UnhandledErrorResponse
      • UpdateOrderItemImageModel
      • UpdateOrderItemModel
      • UpdateOrderItemResponse
      • UpdateOrderModel
      • UpdateOrderModelBulkModel
      • UpdateOrderResponse
      • UpdatePriceModel
      • ValidationErrorResponse
      • VariantAttribute
      • VariantOption
  • Note
    • Notes
      • Create a New Note
      • Search All Notes
      • View Note by ID
      • Update Note
      • Delete Note
      • View Note Audit Logs
    • Schemas
      • CreateNoteModel
      • CreateNoteReponse
      • Error
      • ForbiddenErrorResponse
      • GetAuditLogResponse
      • GetNoteByIdResponse
      • GetNoteResponseItemModel
      • GetNotesResponse
      • NotFoundErrorResponse
      • ResourceFormat
      • ResourceReferenceModel
      • StringAuditEvent
      • UnauthorizedResult
      • UnhandledErrorResponse
      • UpdateNotePayload
      • UpdateNoteResponse
      • UserReferenceModel
      • ValidationErrorResponse
  • Catalog
    • Categories
      • View all product categories
      • Create a new category
      • Update category
      • Delete category
      • Get audit logs of a category
    • MerchantCatalog
      • Create a merchant catalog
        POST
      • Update a merchant catalog
        PUT
      • Partially update a merchant catalog
        PATCH
      • Get a list of merchant catalogs
        GET
      • Delete a merchant catalog
        DELETE
      • Get a merchant catalog and search variants in it
        GET
      • Get a merchant catalog with variants
        GET
      • Get a list of variants the merchant can use in accordance with their enabled catalog
        GET
      • Search for variants in enabled merchant catalog with fallback to global catalog
        POST
      • Get audit logs of a merchant catalog
        GET
    • Products
      • View all products
      • Retrieve product variant details
      • Create a new product
      • Search products
      • Bulk create products
      • Bulk update products
      • Update product
      • Delete product
      • Update variant
      • Get audit logs of a product
    • Variants
      • Delete variant
      • Create a variant
      • Search product variants
      • Get audit logs of a variant
    • Schemas
      • BulkResponse
      • BulkResponseItem
      • CategoryModel
      • CreateCategoryModel
      • CreateCategoryResponse
      • CreateMerchantCatalogDto
      • CreateMerchantCatalogResponse
      • CreateProductModel
      • CreateProductModelBulkModel
      • CreateProductResponse
      • CreateVariantModel
      • CreateVariantResult
      • DecorationModel
      • Error
      • ForbiddenErrorResponse
      • GetAuditLogResponse
      • GetCategoriesResponse
      • GetEffectiveProductsResponse
      • GetEffectiveVariantListResponse
      • GetEffectiveVariantsByProductResponse
      • GetProductVariantsResponse
      • GetProductsResponse
      • ListMerchantCatalogsResponse
      • MerchantCatalogDto
      • MerchantVariantAttributeDto
      • MerchantVariantDto
      • MultiPrice
      • MultiPriceModel
      • NotFoundErrorResponse
      • PatchMerchantCatalogDto
      • PatchMerchantCatalogResponse
      • Price
      • PriceModel
      • PrintImageModel
      • PrintImageUploadStatus
      • PrintMethod
      • ProductAttributeModel
      • ProductAttributeValueModel
      • ProductExtraModel
      • ProductModel
      • ProductStatus
      • ResourceFormat
      • SearchEffectiveVariantsDto
      • SearchEffectiveVariantsResponse
      • SearchEffectiveVariantsSeparateDto
      • SearchEffectiveVariantsSeparateResponse
      • SearchMerchantCatalogVariantsResponse
      • SearchMerchantVariantDto
      • SearchProductsResponse
      • SearchVariantsModel
      • StringAuditEvent
      • UnauthorizedResult
      • UnhandledErrorResponse
      • UpdateCategoryModel
      • UpdateMerchantCatalogDto
      • UpdateMerchantCatalogResponse
      • UpdateProductModel
      • UpdateProductModelBulkModel
      • UpdateProductResponse
      • UpdateProductVariantModel
      • UpdateProductVariantResponse
      • ValidationErrorResponse
      • VariantAttributeModel
      • VariantModel
  • Shipment
    • Packing Slip
      • Generates a packing slip for a specific shipment by Shipment ID.
    • Shipments
      • Get details of a specific shipment by Shipment ID.
      • Update details of a specific shipment by Shipment ID.
      • Create packages for a specific shipment.
      • Delete shipment with packages.
      • Get all shipments for an order by Order ID.
      • Create shipment for order, vendor, and order items.
      • Get shipment with packages for order and vendor.
      • Get shipment details by Order Item ID.
      • Update a specific shipment package.
      • Delete a specific shipment package.
      • Cancel shipment.
      • Unassign items to shipment.
      • Shipment resubmission to assigned facility.
      • Retry outbound polling for a shipment by publishing an OutboundShipmentUpdate event.
      • Search shipments.
      • Reroute shipment.
      • Rejects a shipment.
      • Bulk reroute shipments.
      • Get shipment audit logs.
      • Get package audit logs.
      • Get message audit logs for shipment updates.
      • Assign Shipment.
    • Schemas
      • AssignDTO
      • AssignShipmentResponse
      • BulkResponse
      • BulkResponseItem
      • CancelShipmentDto
      • ConflictErrorResponse
      • CountryCodes
      • CreatePackageDTO
      • CreatePackagesResponse
      • CreateShipmentDTO
      • CreateShipmentResponse
      • CurrencyCodes
      • Error
      • ExternalErrorResponse
      • ForbiddenErrorResponse
      • GeneratePackingSlipResponse
      • GetAuditLogResponse
      • GetOrdersCountByFacilityResponse
      • GetShipmentPollingStoppedCountResponse
      • GetShipmentsCountByStatusResponse
      • GetVendorShipmentsCountByStatusResponse
      • LanguageCodes
      • NotFoundErrorResponse
      • OrderCount
      • OrderItem
      • OrderItemDTO
      • OrderItemImage
      • OrderItemImageDTO
      • OrderItemStatus
      • PackageDTO
      • PackageOrderItemDTO
      • PackingSlipDto
      • Price
      • Reject
      • RejectResponse
      • ReprintDTO
      • Reroute
      • RerouteBulkModel
      • RerouteOrderItem
      • RerouteResponse
      • ResourceFormat
      • SearchShipmentModel
      • SearchShipmentResponse
      • SelectedCarrierShippingServiceMethodDTO
      • SelectedShippingMappingDTO
      • SelectedShippingMappingMethodDTO
      • SelectedVendorMappingDTO
      • ShipmentDTO
      • ShipmentStatus
      • ShipmentsCountByStatus
      • ShippingAddressDTO
      • StringAuditEvent
      • UnassignOrderItemDTO
      • UnauthorizedResult
      • UnhandledErrorResponse
      • UpdatePackageDTO
      • UpdateShipmentDTO
      • ValidationErrorResponse
      • VendorOrderItemModel
      • VendorPackageModel
      • VendorReassignShipmentDTO
      • VendorReassignShipmentResponse
      • VendorRejectShipmentDTO
      • VendorSearchShipmentModel
      • VendorSearchShipmentResponse
      • VendorShipmentResponse
      • VendorUpdateShipmentStatusEnumDTO
      • VendorUpdateTrackingDTO
      • VendorUploadItemImageDTO
      • VendorUploadItemImageResponse
  • Schemas
    • Schemas
      • CreateNoteModel
      • APIClientInfoModel
      • CreateNoteReponse
      • AddRefundItemModel
      • AddRefundModel
      • Error
      • AddressModel
      • ForbiddenErrorResponse
      • AttributeModel
      • GetAuditLogResponse
      • GetNoteByIdResponse
      • BaseAddressModel
      • GetNoteResponseItemModel
      • BillingInfoModel
      • GetNotesResponse
      • BulkResponse
      • BulkResponseItem
      • NotFoundErrorResponse
      • CancelOrderItemModel
      • ResourceFormat
      • ResourceReferenceModel
      • CancelOrderModel
      • CancelOrderResponse
      • StringAuditEvent
      • ConflictErrorResponse
      • UnauthorizedResult
      • CoordinatesModel
      • UnhandledErrorResponse
      • UpdateNotePayload
      • CreateOrderCustomerPaymentMethodModel
      • UpdateNoteResponse
      • CreateOrderCustomerTransactionModel
      • UserReferenceModel
      • CreateOrderItemImageModel
      • CreateOrderItemModel
      • ValidationErrorResponse
      • CreateOrderModel
      • CreateOrderModelBulkModel
      • CreateOrderResponse
      • CustomerCareHoldOrderResponse
      • GetOrderCustomerPaymentMethodModel
      • GetOrderCustomerTransactionModel
      • GetOrderItemImageModel
      • GetOrderItemModel
      • GetOrderItemRefundDataItemModel
      • GetOrderItemRefundDataModel
      • GetOrderItemResponse
      • GetOrderModel
      • GetOrderResponse
      • GetOrdersCountByStatusResponse
      • GetOrdersPollingStoppedCountResponse
      • ListOrderModel
      • ListOrdersResponse
      • OptionModel
      • OrderItemStatus
      • OrderStatus
      • OrdersCountByStatus
      • PriceModel
      • RefreshProcessingModel
      • RefreshProcessingResponse
      • ReprintCostCoverageModel
      • ReprintModel
      • ReprintShipmentItemModel
      • ReprintShipmentModel
      • SearchOrderItemsResponse
      • SearchOrderModel
      • SearchOrdersResponse
      • ShipmentMetadata
      • StartProcessingModel
      • StartProcessingResponse
      • UpdateOrderItemImageModel
      • UpdateOrderItemModel
      • UpdateOrderItemResponse
      • UpdateOrderModel
      • UpdateOrderModelBulkModel
      • UpdateOrderResponse
      • UpdatePriceModel
      • VariantAttribute
      • VariantOption
  1. MerchantCatalog

Partially update a merchant catalog

PATCH
/v1/merchantCatalog
Returns 200 OK for valid/partially valid requests (with errors for invalid variants),
or 400 Bad Request for catalog-level validation failures.

Request

Authorization
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Body Params
application/json

Examples

Responses

🟢200
application/json
OK
Body

🟠400
🟠401
🟠403
🟠404
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://api.stg.ordermesh.io/catalog/v1/merchantCatalog' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "id": "681abd18c61bccfab89bc63e",
    "name": "Updated Catalog Name",
    "description": "This is an updated description for the merchant catalog.",
    "isEnabled": true,
    "assignedToSubAccountIds": [
        "7a2b1d33-c5ef-4a8b-9c7d-5e6f7a8b9c12",
        "15115a31-c5ef-4a8b-9c7d-5e6f7a8b9c12",
        "8b2b1d43-c5ef-4a8b-9c7d-5e6f7a8b9c12"
    ],
    "variantsToAdd": [
        {
            "sku": "newSku123",
            "merchantSku": "newMerchantSku123",
            "merchantPrice": {
                "currencies": [
                    {
                        "amount": 29.99,
                        "currency": "USD"
                    },
                    {
                        "amount": 27.99,
                        "currency": "EUR"
                    }
                ],
                "amount": 29.99,
                "currency": "USD"
            },
            "skipImageManipulation": null,
            "productId": null,
            "decorations": [
                {
                    "area": "Front",
                    "width": 200,
                    "height": 300,
                    "dpi": 300,
                    "method": "DirectToGarment",
                    "price": {
                        "currencies": [
                            {
                                "amount": 12.99,
                                "currency": "USD"
                            },
                            {
                                "amount": 11.99,
                                "currency": "EUR"
                            }
                        ],
                        "amount": 0,
                        "currency": null
                    },
                    "printImage": {
                        "sourcePrintFileUrl": "https://example.com/images/new-front-print.png",
                        "imageUploadStatus": null,
                        "imageUploadStatusDesc": null,
                        "ourPrintFileId": null,
                        "ourPrintFileUrl": null
                    }
                }
            ],
            "attributes": [
                {
                    "name": "Color",
                    "value": "Red"
                },
                {
                    "name": "Size",
                    "value": "Large"
                }
            ]
        }
    ],
    "variantsSkusToRemove": [
        "skuToRemove123",
        "skuToRemove456"
    ],
    "variantsToUpdate": [
        {
            "sku": "existingSku123",
            "merchantSku": "updatedMerchantSku123",
            "merchantPrice": {
                "currencies": [
                    {
                        "amount": 32.99,
                        "currency": "USD"
                    },
                    {
                        "amount": 30.99,
                        "currency": "EUR"
                    }
                ],
                "amount": 32.99,
                "currency": "USD"
            },
            "skipImageManipulation": null,
            "productId": null,
            "decorations": [
                {
                    "area": "Back",
                    "width": 250,
                    "height": 350,
                    "dpi": 300,
                    "method": "Embroidery",
                    "price": {
                        "currencies": [
                            {
                                "amount": 15.99,
                                "currency": "USD"
                            }
                        ],
                        "amount": 0,
                        "currency": null
                    },
                    "printImage": {
                        "sourcePrintFileUrl": "https://example.com/images/back-print-updated.png",
                        "imageUploadStatus": null,
                        "imageUploadStatusDesc": null,
                        "ourPrintFileId": null,
                        "ourPrintFileUrl": null
                    }
                }
            ],
            "attributes": [
                {
                    "name": "Color",
                    "value": "Red"
                },
                {
                    "name": "Size",
                    "value": "Large"
                }
            ]
        }
    ]
}'
Response Response Example
200 - Success
{
    "catalog": {
        "id": "catalog123",
        "ownerMerchantId": "merchant123",
        "name": "Updated Catalog Name",
        "description": "This is an updated description for the merchant catalog.",
        "isEnabled": true,
        "assignedToSubAccountIds": [
            "subAccount1",
            "subAccount2",
            "subAccount3"
        ]
    },
    "variantsAdded": 2,
    "variantsUpdated": 1,
    "variantsRemoved": 3,
    "errors": [
        {
            "errorMessage": "Catalog updated with error",
            "propertyName": "VariantsToAdd",
            "attemptedValue": [
                "invalid-sku-1",
                "invalid-sku-2"
            ]
        }
    ]
}
Modified at 2026-05-27 12:49:07
Previous
Update a merchant catalog
Next
Get a list of merchant catalogs
Built with