UtilitiesUpgrade

listOrgAvailableDeviceVersions

GET
/api/v1/orgs/{org_id}/devices/versions

List available firmware versions for organization devices, optionally filtered by device type and model.

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

Query Parameters

type?string

Filter results by type. enum: ap, gateway, switch

Default"ap"

Value in

  • "ap"
  • "gateway"
  • "switch"
model?string

Fetch version for device model, use/combine with type as needed (for switch and gateway devices). Accepts multiple comma-separated values.

Response Body

curl -X GET "https://example.com/api/v1/orgs/000000ab-00ab-00ab-00ab-0000000000ab/devices/versions"
[  {    "model": "AP41",    "tag": "suggested",    "version": "v0.1.543"  },  {    "model": "AP21",    "version": "v0.1.545"  }]