List installed packages across cluster

GET

/apt/installed

Last modified:2026-09-29 18:51:34

OperationId:ListInstalledPackagesCluster

Lists the NetSapiens packages installed on every cluster server, grouped by package, with the version on each server.

Requires Super User scope.

The server you call asks every server in GET /apt/servers in parallel and waits up to 3 seconds for each. A server that fails or does not answer in time is left out, and the call still answers 200. A package missing from a server can mean that server did not answer: use GET /apt/installed/{hostname} to ask it directly.

Each server answers from a cache that is cleared after every apt change. Set skipcache to true to make every server read apt again, which is slower. The per-server records leave out all_options.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200OK

application/json

Installed packages, one entry per package.

Bodyapplication/json

🟠401Authentication Required

🟠403Forbidden

🟠429Too Many Requests

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/apt/installed?skipcache=true' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Installed packages

[
  {
    "application": "netsapiens-nms",
    "description": "NetSapiens NMS",
    "servers": [
      {
        "hostname": "core1.example.com",
        "version": "46.0.0-alpha.47",
        "upgradable": true,
        "details": {
          "application": "netsapiens-nms",
          "name": "netsapiens-nms-alpha",
          "type": "alpha",
          "version": "46.0.0-alpha.47",
          "version_full": "2:46.0.0-alpha.47-noble",
          "version_index": 45999999.10047,
          "architecture": "amd64",
          "state": "installed",
          "hostname": "core1.example.com",
          "upgradable": true,
          "upgradable_to": "46.0.0-alpha.52",
          "upgradable_full": "2:46.0.0-alpha.52-noble",
          "upgradable_index": 45999999.10052
        }
      },
      {
        "hostname": "core2.example.com",
        "version": "46.0.0-alpha.52",
        "upgradable": false,
        "details": {
          "application": "netsapiens-nms",
          "name": "netsapiens-nms-alpha",
          "type": "alpha",
          "version": "46.0.0-alpha.52",
          "version_full": "2:46.0.0-alpha.52-noble",
          "version_index": 45999999.10052,
          "architecture": "amd64",
          "state": "installed",
          "hostname": "core2.example.com",
          "upgradable": false,
          "upgradable_to": null,
          "upgradable_full": null,
          "upgradable_index": null
        }
      }
    ]
  },
  {
    "application": "repo",
    "description": "The Max version of the repo available on this server",
    "servers": [
      {
        "hostname": "core1.example.com",
        "version": "46.0",
        "upgradable": false,
        "details": {
          "application": "repo",
          "description": "The Max version of the repo available on this server",
          "version": "46.0",
          "hostname": "core1.example.com",
          "upgradable": false,
          "upgradable_to": "46.0"
        }
      }
    ]
  }
]

Modified at 2026-09-29 18:51:34

List cluster servers

List installed packages on server