Update products

Bulk-patches products by id. Successful entities are returned in data; per-item failures in errors.

PATCH/api/v2/{team_slug}/{app_slug}/products

Authorization

AuthorizationBearer token · headerrequired

Management API token, sent as Authorization: Bearer <token>.

Path parameters

team_slugstringrequired

app_slugstringrequired

Request body

requiredapplication/json

productsPatchProductItem[]required

min items 1 · max items 20

Show properties

Array of PatchProductItem

idUUIDrequired

product_namestring

product_numberstring

slugstring

statusstring

Allowed:activedraftinactivearchived

meta_titlestring

meta_descriptionstring

html_descriptionstring

html_short_descriptionstring

tax_group_idUUID

product_dimensionsProductDimension

Show properties

widthinteger

heightinteger

lengthinteger

depthinteger

weightinteger

diameterinteger

capacity_milliliterinteger

package_dimensionsProductDimension

Show properties

widthinteger

heightinteger

lengthinteger

depthinteger

weightinteger

diameterinteger

capacity_milliliterinteger

brand_idUUID

custom_fieldsobject

exclude_from_feedsboolean

product_typestring

Allowed:simpleflexible

market_statusProductMarketStatus[]

Show properties

Array of ProductMarketStatus

market_idUUIDrequired

store_group_idUUIDrequired

market_slugstring

store_group_slugstring

statusstringrequired

Allowed:activeinactivedraftincompletearchived

Responses

200

Patched (partial success possible)

dataProductWrite[]required

Show properties

Array of ProductWrite

idUUIDrequired

product_namestringrequired

product_numberstringrequired

slugstring

statusstringrequired

meta_titlestring

meta_descriptionstring

html_descriptionstring

html_short_descriptionstring

descriptionstring

short_descriptionstring

tax_group_idUUID | null

Show properties

Any of:

UUID

string<uuid>

null

null

brand_idUUID | null

Show properties

Any of:

UUID

string<uuid>

null

null

product_typestring

exclude_from_feedsboolean

product_dimensionsProductDimension | null

Show properties

Any of:

ProductDimension

widthinteger

heightinteger

lengthinteger

depthinteger

weightinteger

diameterinteger

capacity_milliliterinteger

null

null

package_dimensionsProductDimension | null

Show properties

Any of:

ProductDimension

widthinteger

heightinteger

lengthinteger

depthinteger

weightinteger

diameterinteger

capacity_milliliterinteger

null

null

custom_fieldsobject | null

market_statusProductWriteMarketStatus[] | null

Show properties

Array of ProductWriteMarketStatus

marketProductNamedRefrequired

Show properties

idUUIDrequired

namestringrequired

slugstringrequired

store_groupProductNamedRefrequired

statusstringrequired

Allowed:activeinactivedraftincompletearchived

channel_statusesProductChannelStatus[] | null

Show properties

Array of ProductChannelStatus

channel_idUUIDrequired

channel_slugstring

statusstringrequired

created_atstring<date-time>required

updated_atstring<date-time> | null

errorsProductError[]required

Show properties

Array of ProductError

product_numberstring

idUUID | null

Show properties

Any of:

UUID

string<uuid>

null

null

messagestringrequired

400

Request-level failure

errorErrorBodyrequired

Show properties

messagestringrequired

detailsstring[]required

401

Request-level failure

errorErrorBodyrequired

Show properties

messagestringrequired

detailsstring[]required

403

Request-level failure

errorErrorBodyrequired

Show properties

messagestringrequired

detailsstring[]required

500

Request-level failure

errorErrorBodyrequired

Show properties

messagestringrequired

detailsstring[]required

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Parameters

team_slugpath*app_slugpath*

Bodyapplication/json

Request body

{
  "products": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "product_name": "string",
      "product_number": "string",
      "slug": "string",
      "status": "active",
      "meta_title": "string",
      "meta_description": "string",
      "html_description": "string",
      "html_short_description": "string",
      "tax_group_id": "4496f79f-aa1a-4128-84f5-5c1c0836a341",
      "product_dimensions": {
        "width": 0,
        "height": 0,
        "length": 0,
        "depth": 0,
        "weight": 0,
        "diameter": 0,
        "capacity_milliliter": 0
      },
      "package_dimensions": {
        "width": 0,
        "height": 0,
        "length": 0,
        "depth": 0,
        "weight": 0,
        "diameter": 0,
        "capacity_milliliter": 0
      },
      "brand_id": "1bb61461-e5e3-4ebb-8cc6-5b0c37f1b7da",
      "custom_fields": {
        "property1": "string",
        "property2": "string"
      },
      "exclude_from_feeds": true,
      "product_type": "simple",
      "market_status": [
        {
          "market_id": "6364d859-8e1b-477a-bacc-de8305a9292b",
          "store_group_id": "6c760e36-a704-4b09-93bb-c191a46ca67f",
          "market_slug": "string",
          "store_group_slug": "string",
          "status": "active"
        }
      ]
    }
  ]
}

Request

curl -X PATCH 'https://api.enad.io/api/v2/string/string/products' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "products": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "product_name": "string",
      "product_number": "string",
      "slug": "string",
      "status": "active",
      "meta_title": "string",
      "meta_description": "string",
      "html_description": "string",
      "html_short_description": "string",
      "tax_group_id": "4496f79f-aa1a-4128-84f5-5c1c0836a341",
      "product_dimensions": {
        "width": 0,
        "height": 0,
        "length": 0,
        "depth": 0,
        "weight": 0,
        "diameter": 0,
        "capacity_milliliter": 0
      },
      "package_dimensions": {
        "width": 0,
        "height": 0,
        "length": 0,
        "depth": 0,
        "weight": 0,
        "diameter": 0,
        "capacity_milliliter": 0
      },
      "brand_id": "1bb61461-e5e3-4ebb-8cc6-5b0c37f1b7da",
      "custom_fields": {
        "property1": "string",
        "property2": "string"
      },
      "exclude_from_feeds": true,
      "product_type": "simple",
      "market_status": [
        {
          "market_id": "6364d859-8e1b-477a-bacc-de8305a9292b",
          "store_group_id": "6c760e36-a704-4b09-93bb-c191a46ca67f",
          "market_slug": "string",
          "store_group_slug": "string",
          "status": "active"
        }
      ]
    }
  ]
}'

const response = await fetch("https://api.enad.io/api/v2/string/string/products", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"products\": [\n    {\n      \"id\": \"497f6eca-6276-4993-bfeb-53cbbbba6f08\",\n      \"product_name\": \"string\",\n      \"product_number\": \"string\",\n      \"slug\": \"string\",\n      \"status\": \"active\",\n      \"meta_title\": \"string\",\n      \"meta_description\": \"string\",\n      \"html_description\": \"string\",\n      \"html_short_description\": \"string\",\n      \"tax_group_id\": \"4496f79f-aa1a-4128-84f5-5c1c0836a341\",\n      \"product_dimensions\": {\n        \"width\": 0,\n        \"height\": 0,\n        \"length\": 0,\n        \"depth\": 0,\n        \"weight\": 0,\n        \"diameter\": 0,\n        \"capacity_milliliter\": 0\n      },\n      \"package_dimensions\": {\n        \"width\": 0,\n        \"height\": 0,\n        \"length\": 0,\n        \"depth\": 0,\n        \"weight\": 0,\n        \"diameter\": 0,\n        \"capacity_milliliter\": 0\n      },\n      \"brand_id\": \"1bb61461-e5e3-4ebb-8cc6-5b0c37f1b7da\",\n      \"custom_fields\": {\n        \"property1\": \"string\",\n        \"property2\": \"string\"\n      },\n      \"exclude_from_feeds\": true,\n      \"product_type\": \"simple\",\n      \"market_status\": [\n        {\n          \"market_id\": \"6364d859-8e1b-477a-bacc-de8305a9292b\",\n          \"store_group_id\": \"6c760e36-a704-4b09-93bb-c191a46ca67f\",\n          \"market_slug\": \"string\",\n          \"store_group_slug\": \"string\",\n          \"status\": \"active\"\n        }\n      ]\n    }\n  ]\n}"
});

import requests

response = requests.patch(
    "https://api.enad.io/api/v2/string/string/products",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"products\": [\n    {\n      \"id\": \"497f6eca-6276-4993-bfeb-53cbbbba6f08\",\n      \"product_name\": \"string\",\n      \"product_number\": \"string\",\n      \"slug\": \"string\",\n      \"status\": \"active\",\n      \"meta_title\": \"string\",\n      \"meta_description\": \"string\",\n      \"html_description\": \"string\",\n      \"html_short_description\": \"string\",\n      \"tax_group_id\": \"4496f79f-aa1a-4128-84f5-5c1c0836a341\",\n      \"product_dimensions\": {\n        \"width\": 0,\n        \"height\": 0,\n        \"length\": 0,\n        \"depth\": 0,\n        \"weight\": 0,\n        \"diameter\": 0,\n        \"capacity_milliliter\": 0\n      },\n      \"package_dimensions\": {\n        \"width\": 0,\n        \"height\": 0,\n        \"length\": 0,\n        \"depth\": 0,\n        \"weight\": 0,\n        \"diameter\": 0,\n        \"capacity_milliliter\": 0\n      },\n      \"brand_id\": \"1bb61461-e5e3-4ebb-8cc6-5b0c37f1b7da\",\n      \"custom_fields\": {\n        \"property1\": \"string\",\n        \"property2\": \"string\"\n      },\n      \"exclude_from_feeds\": true,\n      \"product_type\": \"simple\",\n      \"market_status\": [\n        {\n          \"market_id\": \"6364d859-8e1b-477a-bacc-de8305a9292b\",\n          \"store_group_id\": \"6c760e36-a704-4b09-93bb-c191a46ca67f\",\n          \"market_slug\": \"string\",\n          \"store_group_slug\": \"string\",\n          \"status\": \"active\"\n        }\n      ]\n    }\n  ]\n}",
)

Response

{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "product_name": "string",
      "product_number": "string",
      "slug": "string",
      "status": "string",
      "meta_title": "string",
      "meta_description": "string",
      "html_description": "string",
      "html_short_description": "string",
      "description": "string",
      "short_description": "string",
      "tax_group_id": "4496f79f-aa1a-4128-84f5-5c1c0836a341",
      "brand_id": "1bb61461-e5e3-4ebb-8cc6-5b0c37f1b7da",
      "product_type": "string",
      "exclude_from_feeds": true,
      "product_dimensions": {
        "width": 0,
        "height": 0,
        "length": 0,
        "depth": 0,
        "weight": 0,
        "diameter": 0,
        "capacity_milliliter": 0
      },
      "package_dimensions": {
        "width": 0,
        "height": 0,
        "length": 0,
        "depth": 0,
        "weight": 0,
        "diameter": 0,
        "capacity_milliliter": 0
      },
      "custom_fields": {
        "property1": "string",
        "property2": "string"
      },
      "market_status": [
        {
          "market": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "name": "string",
            "slug": "string"
          },
          "store_group": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "name": "string",
            "slug": "string"
          },
          "status": "active"
        }
      ],
      "channel_statuses": [
        {
          "channel_id": "bbe8aa76-a4bb-46f6-a785-df8e831cc459",
          "channel_slug": "string",
          "status": "string"
        }
      ],
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "errors": [
    {
      "product_number": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "message": "string"
    }
  ]
}

{
  "error": {
    "message": "string",
    "details": [
      "string"
    ]
  }
}

{
  "error": {
    "message": "string",
    "details": [
      "string"
    ]
  }
}

{
  "error": {
    "message": "string",
    "details": [
      "string"
    ]
  }
}

{
  "error": {
    "message": "string",
    "details": [
      "string"
    ]
  }
}