Skip to content

Smart Inventory Advanced

Advanced write operations for vendors, assets, and processes (ROPA).

Replace {type} with vendor, asset, or process. Replace {id} with the record uniqueId.

Set responsible department

POST /external/smart-inventory/{type}/{id}/responsible-department

Request body

{
  "departmentUniqueId": "dept123"
}

Response

204 No Content on success.

Set responsible person

POST /external/smart-inventory/{type}/{id}/responsible-person

The record must already have a responsible department. The user must belong to that department.

Request body

{
  "responsiblePerson": "a1b2c3d4e5f6"
}

responsiblePerson is the user's uniqueId from GET /company/users/list.

Response

204 No Content on success.

Set process approver

POST /external/smart-inventory/process/{ropa}/approver

ROPA/process only.

Request body

{
  "approver": "a1b2c3d4e5f6"
}

Response

204 No Content on success.

Submit form answers

POST /external/smart-inventory/{type}/{id}/form/submit

Submit answers for custom form fields on a record. Read field uniqueId values from GET .../item first.

Request body

{
  "answers": [
    {
      "uniqueId": "fieldabc123",
      "answer": ["Yes"]
    },
    {
      "uniqueId": "fielddef456",
      "answer": ["Processing is based on consent"]
    }
  ]
}
  • answers — required array, at least one entry
  • uniqueId — form field unique ID from the item response
  • answer — always an array of strings (even for single-value fields)

Response

200 OK with empty body on success.

Example: assign owner to a process

# 1. List departments
curl -X GET https://api.trustview.eu/external/company/departments/list \
  -H "X-API-Key: tvw_sk_live_your_key_here"

# 2. Set department
curl -X POST https://api.trustview.eu/external/smart-inventory/process/6a054b8b9ae1a/responsible-department \
  -H "X-API-Key: tvw_sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"departmentUniqueId": "dept123"}'

# 3. List users
curl -X GET https://api.trustview.eu/external/company/users/list \
  -H "X-API-Key: tvw_sk_live_your_key_here"

# 4. Set responsible person
curl -X POST https://api.trustview.eu/external/smart-inventory/process/6a054b8b9ae1a/responsible-person \
  -H "X-API-Key: tvw_sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"responsiblePerson": "a1b2c3d4e5f6"}'