What parameters does PUT /V1/products/:sku/media/:entryId accept?

This endpoint accepts 2 parameters: sku (string) required; entry (Magento\Catalog\Api\Data\ProductAttributeMediaGalleryEntryInterface) required.

MageSmith

PUTCatalog · Magento 2.4.9 Admin · Magento_Catalog::catalog

PUT /V1/products/:sku/media/:entryId

Q: What does the PUT /V1/products/:sku/media/:entryId endpoint do in Magento 2?

PUT /V1/products/:sku/media/:entryId is a Magento 2 REST endpoint in the Catalog module. Update gallery entry. Requires an admin Bearer token with ACL Magento_Catalog::catalog.

Q: Does PUT /V1/products/:sku/media/:entryId require authentication?

This endpoint requires an admin Bearer token with ACL: Magento_Catalog::catalog.

PUT /V1/products/:sku/media/:entryId is a Magento 2 REST endpoint in the Catalog module. Update gallery entry. Requires an admin Bearer token with ACL Magento_Catalog::catalog.

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

bool

Service contract

Magento\Catalog\Api\ProductAttributeMediaGalleryManagementInterface::update

Authorization

Admin Bearer token with ACL:

Magento_Catalog::catalog

Path parameters

sku string Required

Body parameters

entry Magento\Catalog\Api\Data\ProductAttributeMediaGalleryEntryInterface Required

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.

Headers

application/json

Content-Type

application/json

Authorization

Bearer <ACCESS_TOKEN> admin token with ACL: Magento_Catalog::catalog

Path

/V1/products/{sku}/media/:entryId

Body

{
  "entry": {
    "content": {
      "base64_encoded_data": "",
      "name": "",
      "type": ""
    },
    "disabled": false,
    "extension_attributes": {},
    "file": "",
    "id": 0,
    "label": "",
    "media_type": "",
    "position": 0,
    "types": [
      {}
    ]
  }
}