SuperOps Assets

SuperOps.ai Asset Management

Overview

SuperOps.ai RMM provides comprehensive asset management capabilities. Assets represent managed endpoints (workstations, servers, network devices) with rich telemetry including hardware specs, software inventory, patch status, and activity history. This skill covers querying, managing, and automating actions on assets.

Asset Status Values

| Status | Description | Indicator | |--------|-------------|-----------| | Online | Agent connected and reporting | Green | | Offline | Agent not responding | Red | | Maintenance | In maintenance mode | Yellow |

Asset Platform Types

| Platform | Description | |----------|-------------| | Windows | Windows workstations and servers | | macOS | Apple Mac computers | | Linux | Linux distributions |

Key Asset Fields

Core Fields

| Field | Type | Description | |-------|------|-------------| | assetId | ID | Unique identifier | | name | String | Computer/device name | | status | Enum | Online, Offline, Maintenance | | platform | Enum | Windows, macOS, Linux | | lastSeen | DateTime | Last check-in time | | agentVersion | String | RMM agent version |

Network Fields

| Field | Type | Description | |-------|------|-------------| | ipAddress | String | Primary IP address | | macAddress | String | MAC address | | publicIp | String | External IP | | hostname | String | Network hostname |

Hardware Fields

| Field | Type | Description | |-------|------|-------------| | manufacturer | String | Hardware manufacturer | | model | String | Device model | | serialNumber | String | Serial number | | processorName | String | CPU model | | processorCores | Int | CPU core count | | totalMemory | Long | RAM in bytes | | totalDiskSpace | Long | Total disk space | | freeDiskSpace | Long | Available disk space |

Operating System Fields

| Field | Type | Description | |-------|------|-------------| | osName | String | Operating system name | | osVersion | String | OS version | | osBuild | String | OS build number | | architecture | String | 32-bit or 64-bit |

Association Fields

| Field | Type | Description | |-------|------|-------------| | client | Client | Associated client | | site | Site | Associated site | | tags | [String] | Asset tags | | customFields | [CustomField] | Custom field values |

GraphQL Operations

List Assets

query getAssetList($input: ListInfoInput!) {
  getAssetList(input: $input) {
    assets {
      assetId
      name
      status
      platform
      lastSeen
      ipAddress
      osName
      osVersion
      client {
        accountId
        name
      }
      site {
        id
        name
      }
      patchStatus {
        pendingCount
        installedCount
        failedCount
      }
    }
    listInfo {
      totalCount
      hasNextPage
      endCursor
    }
  }
}

Variables - All Online Assets:

{
  "input": {
    "first": 100,
    "filter": {
      "status": "Online"
    },
    "orderBy": {
      "field": "name",
      "direction": "ASC"
    }
  }
}

Variables - Filter by Client and Platform:

{
  "input": {
    "first": 50,
    "filter": {
      "client": {
        "accountId": "client-uuid"
      },
      "platform": "Windows",
      "status": "Online"
    }
  }
}

Get Asset Details

query getAsset($input: AssetIdentifierInput!) {
  getAsset(input: $input) {
    assetId
    name
    status
    platform
    lastSeen

    # Network
    ipAddress
    macAddress
    publicIp
    hostname

    # Hardware
    manufacturer
    model
    serialNumber
    processorName
    processorCores
    totalMemory

    # OS
    osName
    osVersion
    osBuild
    architecture

    # Disk
    totalDiskSpace
    freeDiskSpace

    # Associations
    client {
      accountId
      name
    }
    site {
      id
      name
      address
    }
    tags
    customFields {
      name
      value
    }

    # Agent
    agentVersion
    agentInstallDate
  }
}

Variables:

{
  "input": {
    "assetId": "asset-uuid-here"
  }
}

Get Asset Software List

query getAssetSoftwareList($input: AssetSoftwareListInput!) {
  getAssetSoftwareList(input: $input) {
    software {
      name
      version
      publisher
      installDate
      size
    }
    listInfo {
      totalCount
      hasNextPage
      endCursor
    }
  }
}

Variables:

{
  "input": {
    "assetId": "asset-uuid",
    "first": 100,
    "filter": {
      "name": "Microsoft"
    }
  }
}

Get Asset Disk Details

query getAssetDiskDetails($input: AssetIdentifierInput!) {
  getAssetDiskDetails(input: $input) {
    disks {
      driveLetter
      volumeName
      fileSystem
      totalSpace
      freeSpace
      usedPercentage
    }
  }
}

Get Asset Patch Details

query getAssetPatchDetails($input: AssetPatchInput!) {
  getAssetPatchDetails(input: $input) {
    patches {
      patchId
      title
      severity
      status
      releaseDate
      kbNumber
      category
    }
    summary {
      pendingCount
      installedCount
      failedCount
      lastScanDate
    }
  }
}

Variables:

{
  "input": {
    "assetId": "asset-uuid",
    "filter": {
      "status": "Pending",
      "severity": ["Critical", "Important"]
    }
  }
}

Get Asset Activity

query getAssetActivity($input: AssetActivityInput!) {
  getAssetActivity(input: $input) {
    activities {
      activityId
      type
      description
      timestamp
      performedBy {
        id
        name
      }
      result
    }
    listInfo {
      totalCount
      hasNextPage
    }
  }
}

Run Script on Asset

mutation runScriptOnAsset($input: RunScriptInput!) {
  runScriptOnAsset(input: $input) {
    actionConfigId
    script {
      scriptId
      name
    }
    arguments {
      name
      value
    }
    status
    scheduledTime
  }
}

Variables:

{
  "input": {
    "assetId": "asset-uuid",
    "scriptId": "script-uuid",
    "arguments": [
      {
        "name": "param1",
        "value": "value1"
      }
    ],
    "runAs": "System",
    "priority": "Normal"
  }
}

Bulk Script Execution

mutation runScriptOnAssets($input: RunScriptOnAssetsInput!) {
  runScriptOnAssets(input: $input) {
    batchId
    assetsCount
    status
    scheduledTime
  }
}

Variables:

{
  "input": {
    "assetIds": ["asset-1", "asset-2", "asset-3"],
    "scriptId": "script-uuid",
    "runAs": "System"
  }
}

Common Workflows

Asset Health Check

# Query assets with low disk space
query getLowDiskAssets($input: ListInfoInput!) {
  getAssetList(input: $input) {
    assets {
      assetId
      name
      freeDiskSpace
      totalDiskSpace
      client { name }
    }
  }
}

Variables:

{
  "input": {
    "filter": {
      "status": "Online",
      "diskSpacePercentFree": {
        "lt": 10
      }
    }
  }
}

Patch Compliance Report

query getPatchCompliance($input: ListInfoInput!) {
  getAssetList(input: $input) {
    assets {
      assetId
      name
      client { name }
      patchStatus {
        pendingCount
        installedCount
        failedCount
        lastScanDate
      }
    }
  }
}

Variables:

{
  "input": {
    "filter": {
      "patchStatus": {
        "hasPending": true,
        "severity": ["Critical"]
      }
    }
  }
}

Software Audit

# Find assets with specific software
query findAssetsWithSoftware($input: ListInfoInput!) {
  getAssetList(input: $input) {
    assets {
      assetId
      name
      client { name }
    }
  }
}

Variables:

{
  "input": {
    "filter": {
      "software": {
        "name": "TeamViewer"
      }
    }
  }
}

Error Handling

Common Errors

| Error | Cause | Resolution | |-------|