What parameters does PUT /V1/products/:sku/downloadable-links/:id accept?

This endpoint accepts 3 parameters: sku (string) required; link (Magento\Downloadable\Api\Data\LinkInterface) required; isGlobalScopeContent (bool).

MageSmith

PUTDownloadable · Magento 2.4.9 Admin · Magento_Downloadable::downloadable

PUT /V1/products/:sku/downloadable-links/:id

Q: What does the PUT /V1/products/:sku/downloadable-links/:id endpoint do in Magento 2?

PUT /V1/products/:sku/downloadable-links/:id is a Magento 2 REST endpoint in the Downloadable module. Update downloadable link of the given product (link type and its resources cannot be changed). Requires an admin Bearer token with ACL Magento_Downloadable::downloadable.

Q: Does PUT /V1/products/:sku/downloadable-links/:id require authentication?

This endpoint requires an admin Bearer token with ACL: Magento_Downloadable::downloadable.

PUT /V1/products/:sku/downloadable-links/:id is a Magento 2 REST endpoint in the Downloadable module. Update downloadable link of the given product (link type and its resources cannot be changed). Requires an admin Bearer token with ACL Magento_Downloadable::downloadable.

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

Returns

int

Service contract

Magento\Downloadable\Api\LinkRepositoryInterface::save

Authorization

Admin Bearer token with ACL:

Magento_Downloadable::downloadable

Path parameters

sku string Required

Body parameters

link Magento\Downloadable\Api\Data\LinkInterface Required

isGlobalScopeContent bool default: true

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_Downloadable::downloadable

Path

/V1/products/{sku}/downloadable-links/:id

Body

{
  "isGlobalScopeContent": false,
  "link": {
    "extension_attributes": {},
    "id": 0,
    "is_shareable": 0,
    "link_file": "",
    "link_file_content": {
      "extension_attributes": {},
      "file_data": "",
      "name": ""
    },
    "link_type": "",
    "link_url": "",
    "number_of_downloads": 0,
    "price": 0,
    "sample_file": "",
    "sample_file_content": {
      "extension_attributes": {},
      "file_data": "",
      "name": ""
    },
    "sample_type": "",
    "sample_url": "",
    "sort_order": 0,
    "title": ""
  }
}