3.3.2. Link

In this chapter, you’ll learn what Link is and how to use it to manage links.

What is Link?#

Link is a class with utility methods to manage links between data models. It’s registered in the Medusa container under the link registration name.

For example:

Code
Show Imports
8
9export async function POST(10  req: MedusaRequest,11  res: MedusaResponse12): Promise<void> {13  const link = req.scope.resolve(14    ContainerRegistrationKeys.LINK15  )16    17  // ...18}

You can use its methods to manage links, such as create or delete links.

Create Link#

To create a link between records of two data models, use the create method of Link.

For example:

Code
1import { Modules } from "@medusajs/framework/utils"2
3// ...4
5await link.create({6  [Modules.PRODUCT]: {7    product_id: "prod_123",8  },9  "helloModuleService": {10    my_custom_id: "mc_123",11  },12})

The create method accepts as a parameter an object. The object’s keys are the names of the linked modules.

The value of each module’s property is an object, whose keys are of the format {data_model_snake_name}_id, and values are the IDs of the linked record.

So, in the example above, you link a record of the MyCustom data model in a hello module to a Product record in the Product Module.

Dismiss Link#

To remove a link between records of two data models, use the dismiss method of Link.

For example:

Code
1import { Modules } from "@medusajs/framework/utils"2
3// ...4
5await link.dismiss({6  [Modules.PRODUCT]: {7    product_id: "prod_123",8  },9  "helloModuleService": {10    my_custom_id: "mc_123",11  },12})

The dismiss method accepts the same parameter type as the create method.

Cascade Delete Linked Records#

If a record is deleted, use the delete method of Link to delete all linked records.

For example:

Code
1import { Modules } from "@medusajs/framework/utils"2
3// ...4
5await productModuleService.deleteVariants([variant.id])6
7await link.delete({8  [Modules.PRODUCT]: {9    product_id: "prod_123",10  },11})

This deletes all records linked to the deleted product.

Restore Linked Records#

If a record that was previously soft-deleted is now restored, use the restore method of Link to restore all linked records.

For example:

Code
1import { Modules } from "@medusajs/framework/utils"2
3// ...4
5await productModuleService.restoreProducts(["prod_123"])6
7await link.restore({8  [Modules.PRODUCT]: {9    product_id: "prod_123",10  },11})