API · v1 · stabil
CODEMETA OSDeveloper Center
Konsole öffnen
Entity · rmm_devices

RMM Device

Schema-ID
rmm_device
Collection
rmm_devices
Permissions
  • Lesenrmm_device_view
  • Anlegenrmm_device_create
  • Ändernrmm_device_edit
  • Löschenrmm_device_delete
Beziehungen

Felder

RMM Device

rmm_devices4 Permissions

Read-only mirror of an RMM-managed device/asset (ADR 0186 / 0244).

providerstringoptional

Which RMM produced this mirror. Absent on pre-0244 docs → octoja.

Werte
octojaninjaoneriverbird
Default: "octoja"read-only
externalDeviceIdstringoptional

Provider-generic device id. Read fallback: externalDeviceId ?? octojaAssetId.

read-onlynullable
externalOrgIdstringoptional

Provider-generic customer/org id (NinjaOne organization / Octoja customer).

read-onlynullable
octojaAssetIdstringoptional

Legacy Octoja asset id (deprecated; kept as fallback for externalDeviceId).

read-onlynullable
partyIduuidoptional

Resolved Codemeta party (via Octoja customerId → externalReferences).

read-onlynullable
assetIduuidoptional→ asset

Optional link to a user-owned CMDB asset (serial-match or manual).

read-onlynullable
linkSourcestringoptional

How assetId was set. 'manual' is never overwritten by the auto-matcher.

Werte
noneauto-serialmanual
Default: "none"read-only
linkStatusstringoptional

ambiguous = >1 serial match (manual queue); conflict = customer mismatch.

Werte
unlinkedlinkedambiguousconflict
Default: "unlinked"read-only
octojaCustomerIdstringoptional
read-onlynullable
customerNamestringoptional
read-onlynullable
octojaCustomerSiteIdstringoptional
read-onlynullable
customerSiteNamestringoptional
read-onlynullable
deviceNamestringerforderlich
read-only
deviceAliasstringoptional
read-onlynullable
deviceTypestringoptional
read-onlynullable
deviceKindstringoptional
Werte
UnknownWindowsServerWindowsWorkstationLinuxServerLinuxDesktopMacOS
Default: "Unknown"read-only
operatingSystemstringoptional
read-onlynullable
isOnlinebooleanoptional
Default: falseread-only
lastSeenAtdatetimeoptional
read-onlynullable
lastReportedAtdatetimeoptional
read-onlynullable
manufacturerstringoptional
read-onlynullable
modelstringoptional
read-onlynullable
serialNumberstringoptional
read-onlynullable
agentVersionstringoptional
read-onlynullable
latestAgentVersionstringoptional
read-onlynullable
agentUpdateAvailablebooleanoptional
Default: falseread-only
publicIpAddressstringoptional
read-onlynullable
lastLoggedInUserstringoptional
read-onlynullable
lastLoggedInUserDisplayNamestringoptional
read-onlynullable
checkStatusobjectoptional
read-onlynullable
totalintegeroptional
Default: 0
okintegeroptional
Default: 0
warningintegeroptional
Default: 0
criticalintegeroptional
Default: 0
detailsobject[]optional
Default: []
namestringoptional
statusstringoptional
Werte
SuccessWarningCriticalFailure
providerCheckStatesobject[]optional

Last known raw check result per provider check id. Used for RAISE/CLEAR transition detection on polling providers. Absent on devices from webhook-based providers.

Default: []nullable
externalCheckIdstringoptional
resultintegeroptional
checkNamestringoptional
nullable
lastChangedAtdatetimeoptional
nullable
lastSeenAtdatetimeoptional
read-onlynullable
securityScorenumberoptional

Lywand vulnerability score (0–100, higher is better).

read-onlynullable
securityScoreUpdatedAtdatetimeoptional
read-onlynullable
tagsobject[]optional
Default: []read-only
valuestringoptional
sourcestringoptional
Werte
UserInventory
octojaLastSyncAtdatetimeoptional

When Codemeta last mirrored this device from Octoja.

read-onlynullable

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/rmm_devices — Liste, paginiert + filterbar
  • GET /api/v1/rmm_devices/<id> — Einzelne Entity
  • POST /api/v1/rmm_devices — Anlegen
  • PATCH /api/v1/rmm_devices/<id> — Teil-Update
  • DELETE /api/v1/rmm_devices/<id> — Soft-Delete
  • GET /api/v1/rmm_devices/<id>/timeline — Audit + Aktivitäten

Suche