Partially update a merchant catalog

PATCH

/v1/merchantCatalog

Vendor Access: Forbidden — This endpoint is not accessible to vendor users.

Updates only the catalog fields present in the request; its variants are not changed.
Manage variants with the /merchantVariants endpoints.
Returns 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

Body

🟠400

🟠401

🟠403

🟠404

🟠409

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://api.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"
    ]
}'

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"
        ]
    }
}

Modified at 2026-10-23 15:21:26

Update a merchant catalog

Get a list of merchant catalogs