Asset Schema
Felder
Asset Schema
Schema for validating asset entities
name
Asset name. Optional — peripherals and small items often do not have a meaningful name; identification then happens via manufacturer + model + serialNumber.
status
Asset status
ACTIVEINACTIVERETIREDIN_REPAIRORDEREDpartyId
Associated party UUID
partyAddressId
Specific site/address of the associated party
locationId
Reference to a Location entity (e.g. specific room at the site)
rackStartUnit
Starting rack unit (HE) position, 1-based from bottom
rackHeightUnits
Number of rack units (HE) this asset occupies
rackSide
Which side of the rack the asset is mounted on
FRONTREARnullassetTemplateId
Reference to an asset_template (device type library) — inherits dimensions + port layout
contactPartyId
Associated contact person UUID
notes
Free-text notes or description
locationDescription
Physical location description
serialNumber
Serial number
manufacturer
Manufacturer name
model
Model name
ean
EAN / GTIN barcode (e.g. imported from weclapp article)
manufacturerPartNumber
Manufacturer part number / MPN (Hersteller-Teilenummer)
customsTariffNumber
Customs tariff number / HS code (Zolltarifnummer)
weight
Net weight in kilograms (Nettogewicht, e.g. from weclapp article)
grossWeight
Gross weight in kilograms (Bruttogewicht, e.g. from weclapp article)
length
Length in meters (Länge, e.g. from weclapp article)
width
Width in meters (Breite)
height
Height in meters (Höhe)
unit
Base unit (Grundeinheit, e.g. "Stk." from weclapp article)
countryOfOrigin
Country of origin (Ursprungsland, ISO code or name)
purchaseDate
Purchase date in YYYY-MM-DD format
warrantyExpiresAt
Warranty expiration date
purchasePrice
Purchase price (Einkaufspreis) in EUR
salesPrice
Sales price (Verkaufspreis) in EUR
contractId
Associated contract UUID
tags
Asset tags
imageFileIds
File IDs of asset photos
linkedEntities
ipAddress
IP address for endpoint assets
macAddress
MAC address for endpoint assets
hostname
Hostname for endpoint assets
dynDns
Dynamic DNS hostname for endpoint assets
room
Room or physical location within the building
serviceUserId
Assigned service technician (user UUID)
inventoryNumber
Internal inventory number
ownershipType
Whether the device is company-owned or external
OWNEXTERNALteamviewerDeviceId
TeamViewer device ID (from sync)
teamviewerRemoteControlId
TeamViewer remote control ID (rXXXXXXXXX)
anydeskId
AnyDesk ID for remote access
agentId
Bound desktop agent machine ID (UUIDv7)
agentStatus
Agent connection status
ONLINEOFFLINESTALEUNREGISTEREDagentLastSeenAt
Last heartbeat timestamp from agent
agentVersion
Desktop agent software version
agentPool
True if auto-enrolled and not yet assigned to a party
primaryUserName
OS account name of the currently logged-in user (e.g. sAMAccountName)
primaryUserDomain
NETBIOS / AD domain of the logged-in user
primaryUserDisplayName
Display name of the logged-in user (e.g. "John Doe")
primaryUserEmail
Email/UPN of the logged-in user (used to auto-link to a Person party)
primaryUserUpn
User principal name from Windows AAD/AD (user@tenant.tld)
primaryUserPartyId
Party UUID auto-resolved from primaryUserEmail. Set by the agent heartbeat handler on email match; cleared when the email no longer matches.
primaryUserUpdatedAt
Timestamp of the last primaryUser change (for audit / staleness detection)
agentPrinters
Printers reported by a print-capable agent (ADR 0321).
id
name
driver
connection
isDefault
mediaWidthMm
mediaHeightMm
status
dependsOn
Upstream asset-IDs this asset depends on. Open incidents on any upstream suppress new child-incidents until the parent resolves (cascade-unsuppress).
probe
Probe-Agent configuration (ADR 0061)
osEdition
OS edition (e.g. Windows 11 Pro)
osBuild
OS build number
osArchitecture
OS architecture
x86x64arm64lastBootTime
Last system boot time (from agent inventory)
biosVendor
BIOS vendor name
biosVersion
BIOS version string
chassisType
Physical chassis type (auto-detected by agent)
DESKTOPLAPTOPSERVERTABLETMINI_PCALL_IN_ONEOTHERtotalRamGb
Total installed RAM in GB (from agent inventory)
tpmVersion
TPM spec version (e.g. "2.0"), null if absent/not reported
licenseKey
License key for software assets
seats
Number of license seats
expiresAt
License expiration date
criticality
Asset criticality for business operations
LOWMEDIUMHIGHCRITICALrto
Recovery Time Objective in hours
rpo
Recovery Point Objective in hours
businessImpact
Description of business impact if asset is unavailable
downtimeCostPerHour
Estimated cost per hour of downtime
redundancyType
Redundancy configuration
NONEACTIVE_PASSIVEACTIVE_ACTIVEN_PLUS_1CLUSTERemergencyContact
Emergency contact information
recoveryNotes
Recovery procedure notes
vendor
Software vendor name
appVersion
Application version
deploymentType
Deployment type
ON_PREMISECLOUDHYBRIDSAASurl
Application or website URL
processOwner
Process owner name or role
frequency
How often the process runs
CONTINUOUSDAILYWEEKLYMONTHLYQUARTERLYYEARLYON_DEMANDinputSystems
Systems providing input to this process
outputSystems
Systems receiving output from this process
hostingProvider
Hosting provider name
sslExpiresAt
SSL certificate expiration date
cms
Content management system
monitoringUrl
Monitoring dashboard URL
cloudProvider
Cloud service provider
AWSAZUREGCPHETZNEROTHERserviceType
Type of cloud service (e.g. IaaS, PaaS, SaaS)
region
Cloud region or data center location
accountId
Cloud account identifier
monthlyBudget
Monthly budget for this cloud service
dbEngine
Database engine (e.g. PostgreSQL, MySQL, MongoDB)
dbVersion
Database version
sizeGb
Database size in GB
backupSchedule
Backup schedule (e.g. cron expression or description)
replicationMode
Database replication mode
NONEPRIMARY_REPLICAMULTI_MASTERCLUSTERbackupType
Backup strategy type
FULLINCREMENTALDIFFERENTIALSNAPSHOTretentionDays
Backup retention period in days
targetStorage
Target storage location for backups
lastBackupAt
Last successful backup timestamp
schedule
Backup or sync schedule
commType
Communication system type
EMAILPHONECHATVIDEOFAXprovider
Service provider
userCount
Number of users on this system
domainName
Fully qualified domain name
registrar
Domain registrar name
domainExpiresAt
Domain registration expiry date
autoRenew
Whether domain auto-renews
renewalMode
INWX renewal mode. AUTOEXPIRE = scheduled for expiry at period end (cancelled by user).
AUTORENEWAUTOEXPIREAUTODELETERENEWONCEcancelledAt
Timestamp when the domain was scheduled for cancellation (set to AUTOEXPIRE)
cancelledBy
User ID who scheduled the cancellation
lastDnsScore
Most recent DNS health score (0–100)
dnsReport
Embedded DNS report with records, checks, score, and recommendations
nameservers
Nameserver hostnames (e.g. ns.inwx.de)
useInwxNameservers
Whether DNS is managed via INWX nameservers
inwxDomainId
INWX domain ID for synchronization
inwxSyncStatus
Current INWX synchronization status
syncedsyncingconflicterrorlastSyncAt
Timestamp of last successful INWX sync
ownerPartyId
Party used as INWX owner handle
adminPartyId
Party used as INWX admin handle
techPartyId
Party used as INWX tech handle
billingPartyId
Party used as INWX billing handle
transferStatus
Domain transfer status
nonependingin_progresscompletedfailedtransferLock
Whether the domain transfer lock is enabled
whoisPrivacy
Whether WHOIS privacy protection is enabled
dnssecEnabled
Whether DNSSEC is enabled for this domain
subnet
Subnet in CIDR notation (e.g. 192.168.1.0/24)
vlanId
VLAN ID (1-4094)
gateway
Default gateway IP address
networkType
Network type classification
LANWLANWANVPNDMZVLANSD_WANOTHERperipheralDeviceType
Peripheral device type category
MONITORKEYBOARDMOUSEHEADSETWEBCAMDOCKING_STATIONUPSPROJECTORSCANNEREXTERNAL_STORAGEKVM_SWITCHPRINTERLABEL_PRINTEROTHERarticleNumber
Manufacturer article/part number
peripheralType
Connection or technology type (e.g. USB-C, Bluetooth, DECT)
hypervisorAssetId
Reference to the host server asset (hypervisor)
hypervisorType
Hypervisor platform — on servers: editable source of truth; on VMs: denormalized from linked server (read-only in UI)
VMWARE_ESXIHYPER_VPROXMOXKVMXENvCpu
Number of virtual CPUs
ramGb
Allocated RAM in GB
diskGb
Allocated disk space in GB
guestOs
Guest operating system
vmId
Hypervisor-internal VM identifier (e.g. VMware BIOS UUID)
clusterName
Cluster name (ESXi/Hyper-V cluster or Kubernetes cluster)
datastoreName
Datastore or storage volume name
haEnabled
Whether high availability is enabled
snapshotCount
Number of VM snapshots
mobileDeviceType
Mobile device type
SMARTPHONETABLETimei
IMEI (International Mobile Equipment Identity)
meid
MEID (Mobile Equipment Identifier)
simNumber
SIM card number (ICCID)
phoneNumber
Phone number
carrier
Mobile carrier / provider
osName
Operating system name (e.g. iOS, Android)
osVersion
Operating system version
mdmEnrolled
Whether the device is enrolled in MDM
mdmProvider
MDM provider (e.g. Intune, Jamf, MobileIron)
screenLockPolicy
Screen lock policy (e.g. PIN, Biometric)
encryptionEnabled
Whether device encryption is enabled
storageType
Storage system type
SANNASDASOBJECT_STORAGEtotalCapacityGb
Total storage capacity in GB
usedCapacityGb
Used storage in GB
raidLevel
RAID level
RAID_0RAID_1RAID_5RAID_6RAID_10RAID_Z1RAID_Z2NONEprotocols
Supported storage protocols
lunCount
Number of LUNs (Logical Unit Numbers)
ssids
Broadcast SSIDs
frequencyBand
Supported frequency band
2_4GHZ5GHZ6GHZDUAL_BANDTRI_BANDwlanStandard
WLAN standard (e.g. 802.11ax, Wi-Fi 6E)
channel
Radio channel
channelWidth
Channel width in MHz
204080160controllerAssetId
Reference to the WLAN controller asset
poeEnabled
Whether PoE (Power over Ethernet) is enabled
maxClients
Maximum number of connected clients
portCount
Total number of physical ports on the switch
uplinkPortCount
Number of SFP/uplink ports
switchManaged
Management type of the switch
MANAGEDSMARTUNMANAGEDswitchLayer
Switching layer (L2, L2+, L3)
L2L2_PLUSL3poeSupport
PoE support level (802.3af / 802.3at / 802.3bt)
NONEPOEPOE_PLUSPOE_PLUS_PLUSpoeBudgetWatts
Total PoE power budget in watts
stackable
Whether this is a stackable switch
stackMasterAssetId
Reference to the stack master asset
orchestratorType
Container orchestrator platform
KUBERNETESDOCKER_SWARMOPENSHIFTNOMADOTHERk8sVersion
Kubernetes / orchestrator version
nodeCount
Number of cluster nodes
registryUrl
Container registry URL
environment
Deployment environment
DEVSTAGINGPRODtotalCpuCores
Total CPU cores across all nodes
clusterTotalRamGb
Total RAM across all nodes in GB
namespaceCount
Number of namespaces
pbxType
PBX deployment type
ON_PREMISECLOUDHYBRIDpbxVendor
PBX vendor (e.g. 3CX, Starface, Auerswald)
extensionCount
Number of extensions / Nebenstellen
maxConcurrentCalls
Maximum concurrent calls
sipProvider
SIP trunk provider
sipTrunkCount
Number of SIP trunks
didRange
DID number range (e.g. +49 656 169944-0 to -99)
srtpEnabled
Whether SRTP (Secure RTP) is enabled
codecSupport
Supported audio codecs (e.g. G.711, G.729, Opus)
callRecordingEnabled
Whether call recording is enabled
repairStartedAt
Timestamp when repair started (auto-set on transition to IN_REPAIR)
repairCompletedAt
Timestamp when repair was completed (auto-set on transition from IN_REPAIR)
repairNotes
Repair notes (initial diagnosis, visible damage, etc.)
repairTicketId
Quick-link to the associated repair ticket
intakeReceivedAt
Timestamp when the device was received at intake (Annahmezeitpunkt)
intakeReceivedBy
User who accepted the device at intake (Annahme durch)
intakeAccessories
Accessories / included items handed in with the device (Zubehör)
intakeCondition
Documented condition at intake (visible damage, scratches, etc.)
intakePhotoFileIds
File IDs of condition photos taken at intake (separate from imageFileIds)
intakeSignatureFileId
File ID of the customer signature PNG captured at intake
storageLocation
Free-text physical storage slot/shelf (Regal-/Stellplatz); distinct from room
intakeStage
Repair-intake lifecycle stage driving the Warenannahme board; separate from the CMDB status (legacy docs derive it from status at runtime)
RECEIVEDIN_REPAIRREADY_FOR_PICKUPPICKED_UPpickupDueAt
Planned pickup date for the repair device (mirrored from the repair ticket)
linkedRiskIds
Linked risk IDs
linkedTomIds
Linked TOM IDs
components
Internal hardware components (RAM, CPU, HDD, etc.)
id
Unique component identifier (UUIDv7)
category
Component category
RAMCPUGPUHDDSSDPSUMAINBOARDNICOPTICAL_DRIVEEXPANSION_CARDOTHERmanufacturer
Component manufacturer
model
Component model name
serialNumber
Component serial number
specification
Free-text specification (e.g. "32 GB DDR5 4800 MHz")
quantity
Number of identical components
status
Component health status
OKDEGRADEDFAILEDREPLACEDinstalledAt
Installation date
notes
Free-text notes
Keine Felder passen zum Filter.
Standard-Endpoints
Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:
GET /api/v1/assets— Liste, paginiert + filterbarGET /api/v1/assets/<id>— Einzelne EntityPOST /api/v1/assets— AnlegenPATCH /api/v1/assets/<id>— Teil-UpdateDELETE /api/v1/assets/<id>— Soft-DeleteGET /api/v1/assets/<id>/timeline— Audit + Aktivitäten