Agents

Fleet agent version inventory and skew summary

GET
/organizations/{organizationId}/agents/version-inventory

Path Parameters

organizationId*string
Formatuuid

Header Parameters

x-organization-role*string

Portal impersonation role (pair with x-organization-id)

Value in

  • "ORG_ADMIN"
  • "ORG_MEMBER"
x-organization-id*string

Must match the organizationId path segment

Formatuuid

Response Body

application/json

application/json

curl -X GET "https://example.com/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/agents/version-inventory" \  -H "x-organization-role: ORG_ADMIN" \  -H "x-organization-id: 497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "agents": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "agentVersion": "string",      "targetVersion": "string",      "upgradeStatus": "current",      "versionPinned": true,      "status": "string"    }  ],  "distinctVersionCount": 0,  "versionSkewWarning": true,  "policy": {    "defaultTargetVersion": "string",    "autoUpgrade": true,    "maintenanceWindowUtc": "string",    "maxConcurrentUpgrades": 0  },  "availableVersions": [    "string"  ]}
{  "message": "string"}