v1

latestOpenAPI 3.1.0Apache 2.02026-07-245981,1853.0 MB

Inventory Relationships V1

Create Control Implementation

Use this API to create one or more control implementations on an inventory using the type and id for the inventory item and the id(s) of the master controls. When the operation is run unsuccessfully, this will return an exception.

post/api/inventory/v2/inventories/{type}/{inventoryId}/control-implementations

Path parameters

type'processing-activities' | 'vendors' | 'assets' | 'entities' required

The type of inventory to add controls to

inventoryIdstring uuid required

The unique identifier of an inventory record. This value can be obtained using the Get List of Inventories API.

Request body

controlIdsstring[] required

Set of control IDs to be implemented for the given inventory entity

status'Implemented' | 'Not Implemented' | 'Partially Implemented' | 'Not Applicable' | 'Pending'

Implementation status of the controls being added to the inventory. If not provided, defaults to 'Pending'

Example request

{
  "controlIds": [
    "a8d2f0c6-63e5-476b-b600-79a447251a2a",
    "b9e3f1d7-74f6-587c-c711-8ba558362b3b"
  ],
  "status": "Implemented"
}

Response

Created