---
title: "Link Inventory"
method: POST
path: "/api/inventory/v2/inventories/{id}/relations"
tags: ["Inventory Relationships V1"]
---

# Link Inventory

`POST /api/inventory/v2/inventories/{id}/relations`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/api/inventory/v2/inventories/{id}/relations`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `INVENTORY`, `INVENTORY_WRITE`

Use this API to create a bidirectional link between an inventory and one or more other inventories.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `entityType` 'processing-activities' | 'vendors' | 'assets' | 'entities'

## Request body

- InventoryAssociationCreateRequest[]
  - `relation` 'ControllerLinkType' | 'JointControllerLinkType' | 'RelatedLinkType' | 'RecipientOfSaleLinkType' | 'SubProcessorLinkType' | 'ProcessorLinkType' | 'DestinationAccessLinkType' | 'ProductOrServiceProviderLinkType' | 'StorageProcessingLinkType' | 'SourceCollectionLinkType': The type of relationship between inventory records
  - `id` string, uuid, required: The unique identifier of the inventory record to link to
  - `entityType` string: The type of the inventory entity

## Response `200`

OK

- BaseInventoryAssociationDto[]
  - `inventoryId` string, uuid: The unique identifier of the linked inventory record
  - `inventoryAssociationId` string, uuid: The unique identifier of the association between inventory records

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500`: Internal Server Error

---

[API](https://skmtc.dev/onetrust/apis/privacy-automation-data-mapping-automation.md) - [All operations](https://skmtc.dev/onetrust/apis/privacy-automation-data-mapping-automation/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/privacy-automation-data-mapping-automation/revisions/daead5d9fad6?raw)