Mist API Reference
Mist Automation Guide
HomeSDKsAPI ReferenceContext Plugin
UtilitiesUpgrade

listOrgMxEdgeUpgrades

GET
/api/v1/orgs/{org_id}/mxedges/upgrade

List Mist Edge upgrade requests for the organization, including status, rollout strategy, target versions, and per-status target counts.

Authorization

Authorization<token>

Preferred authentication method for automation and integrations. Send the API token in the HTTP Authorization header.

Format: Authorization: Token {apitoken}

Notes:

  • An API token generated for a specific admin has the same privileges as that admin
  • An API token is automatically removed if it is not used for more than 90 days
  • SSO admins cannot generate admin API tokens. Use organization API tokens when scoped Org/Site privileges are needed.

In: header

Path Parameters

org_id*string
Formatuuid

Response Body

curl -X GET "https://example.com/api/v1/orgs/000000ab-00ab-00ab-00ab-0000000000ab/mxedges/upgrade"
[  {    "channel": "string",    "counts": {      "failed": 0,      "queued": 0,      "success": 0,      "upgrading": 0    },    "id": "53f10664-3ce8-4c27-b382-0ef66432349f",    "status": "string",    "strategy": "string",    "versions": {}  }]

upgradeOrgDevices POST

Start an organization-level device upgrade job across selected sites. The request selects device type, sites, models, firmware versions, and upgrade strategy; AP-specific and Junos-specific options apply only where supported.

upgradeOrgMxEdges POST

Schedule a Mist Edge upgrade for selected Mist Edges, using service target versions or an optional Linux distro upgrade with rollout strategy and canary settings.