Update governance metadata (and tags) on one asset.
Requires the inventory:write scope. Governance fields only; employee rows are read-only.
Authorizations
Bearer access token obtained from /oauth/token.
Path Parameters
Body
Governance-only metadata update. Governance fields only - no name, device facts, status, create or delete.
Data classification.
"CONFIDENTIAL"
Governance description (max 500 chars).
500"Primary production web server."
New owner's employee UUID.
"a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
Tags to set (single-asset PATCH only; not supported in bulk). Diffed add/remove against existing customer tag keys; an unknown key is rejected.
20Response
OK
Public asset. The id is an opaque public reference (never the internal PK); for EMPLOYEE-category rows it is the stable employee UUID. Category-specific fields are populated only for their owning category; completeStatus is read-only.
Cloud account id (CLOUD assets).
"123456789012"
Asset category key.
CLOUD, COMPUTER, CUSTOM, INFORMATION, EMPLOYEE "CLOUD"
Data classification.
"CONFIDENTIAL"
Read-only completeness status. COMPLETE when an owner is assigned, else INCOMPLETE. Applies to all categories.
COMPLETE, INCOMPLETE "COMPLETE"
Creation timestamp (UTC).
"2026-01-15T09:30:00.000Z"
User/patient-data flags for INFORMATION/CUSTOM assets. Read-only.
Governance description.
"Primary production web server."
Employee email - PII, surfaced under inventory:read (EMPLOYEE assets).
"jane.doe@example.com"
Identifier of the asset in its source system.
"i-0abc123def456"
Opaque public asset id (UUID).
"3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f"
Timestamp of the last compliance check (UTC), where applicable.
"2026-06-30T02:00:00.000Z"
Asset display name.
"prod-web-01"
Operating system family and version, combined (COMPUTER assets).
"macOS 14.5"
Owner's employee UUID.
"a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
Origin of the owner assignment.
"MANUAL"
Cloud region/location (CLOUD assets).
"eu-central-1"
Hardware serial number (COMPUTER assets).
"C02XY1234ABC"
Structured tags on the asset.
Asset type within its category.
"SERVER"