Sign in

v1

latestOpenAPI 3.1.0Apache 2.02026-07-245981,1853.0 MB
Inventory

Update Inventory by ID

Use this API to update the existing inventory. The body of the update request should contain a single object with fields in the same format as the output of the inventory detail endpoint. Only include the fields that need to be updated.

put/api/inventory/v2/inventories/{schemaName}/{id}

Path parameters

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

The name property of the schema.

idstring uuid required

The unique identifier of an inventory record.

Query parameters

primaryEntityboolean

Flag to indicate if this is a primary entity update.

Request body

inventoryIdsstring[]

List of inventory record UUIDs to be updated.

inventoryRequestJsonNode

Example request

{
  "inventoryIds": [
    "c79fb1a9-9406-4e9b-bff7-c72e635ee82b"
  ],
  "inventoryRequest": {
    "name": "New Vendor",
    "status": "active"
  }
}

Response

OK - Inventory successfully updated.

OR
OR
OR

Example response

{
  "data": {
    "id": "96214230-ffbb-4870-b6c4-0f30c3bfec60",
    "canViewDetails": true,
    "name": "Vendor XYZ",
    "riskLevel": "HIGH",
    "riskScore": 8.5,
    "status": {
      "key": "active",
      "name": "Active"
    },
    "externalId": "EXT-12345",
    "createdDate": "2023-01-15T10:30:45.123Z",
    "updatedDate": "2023-02-20T14:15:30.456Z",
    "selectFields": {
      "data-residency": [
        {
          "key": "us",
          "value": "US"
        }
      ]
    },
    "textFields": {
      "description": "Sample description"
    },
    "number": 123,
    "isParent": true,
    "inheritFromMaster": true,
    "parentInventoryId": "96214230-ffbb-4870-b6c4-0f30c3bfec60",
    "masterRecord": "MASTER-001",
    "workflowStage": {
      "badgeColor": "#4CAF50"
    },
    "inherentRiskLevel": "MEDIUM",
    "inherentRiskScore": 6.5,
    "targetRiskLevel": "LOW",
    "targetRiskScore": 3,
    "totalHierarchyRiskLevel": "HIGH",
    "totalHierarchyRiskScore": 8,
    "totalHierarchyInherentRiskLevel": "MEDIUM",
    "totalHierarchyInherentRiskScore": 6,
    "totalHierarchyTargetRiskLevel": "LOW",
    "totalHierarchyTargetRiskScore": 3,
    "inventoryDeleteType": "SOFT",
    "deletedReason": "No longer required",
    "deletedBy": "ab0b11d9-8ba2-46f3-b845-2ca50bef4efc",
    "deletedDate": "2023-03-01T12:00:00.000Z",
    "isGlobalAttributeConfigurationEnabled": true,
    "sourceId": "c79fb1a9-9406-4e9b-bff7-c72e635ee82b",
    "integrationWorkflowId": "wf-123",
    "sourceType": "API_INTEGRATION",
    "reviewType": "ANNUAL"
  }
}