What parameters does POST /V1/products/:sku/links accept?

This endpoint accepts 2 parameters: sku (string) required; items (Magento\Catalog\Api\Data\ProductLinkInterface[]) required.

MageSmith

POSTCatalog · Magento 2.4.9 Admin · Magento_Catalog::catalog

POST /V1/products/:sku/links

Q: What does the POST /V1/products/:sku/links endpoint do in Magento 2?

POST /V1/products/:sku/links is a Magento 2 REST endpoint in the Catalog module. Assign a product link to another product. Requires an admin Bearer token with ACL Magento_Catalog::catalog.

Q: Does POST /V1/products/:sku/links require authentication?

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

POST /V1/products/:sku/links is a Magento 2 REST endpoint in the Catalog module. Assign a product link to another product. 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\ProductLinkManagementInterface::setProductLinks

Authorization

Admin Bearer token with ACL:

Magento_Catalog::catalog

Path parameters

sku string Required

Body parameters

items Magento\Catalog\Api\Data\ProductLinkInterface[] 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}/links

Body

{
  "items": [
    {
      "extension_attributes": {},
      "link_type": "",
      "linked_product_sku": "",
      "linked_product_type": "",
      "position": 0,
      "sku": ""
    }
  ]
}