# Retrieve the currently running firmware upgrade campaign

Requires upgrade-manager::read permission.

Endpoint: GET /upgrade-manager/api/v1/upgrades/active
Version: 1.0.0
Security: JWTAuthorizer

## Response 200 fields (application/json):

  - `clusterUpgrades` (array)

  - `clusterUpgrades.error` (string)
    Error message

  - `clusterUpgrades.fqdn` (string)
    Cluster FQDN
    Example: "mycluster.trustgrid.io"

  - `clusterUpgrades.nodeUpgrades` (array)

  - `clusterUpgrades.nodeUpgrades.name` (string)
    Node name
    Example: "mynode"

  - `clusterUpgrades.nodeUpgrades.nodeID` (string)
    Node ID
    Example: "19084f81-5668-41ee-adbe-295e4c65531a"

  - `clusterUpgrades.nodeUpgrades.state` (string)
    Upgrade state

  - `clusterUpgrades.nodeUpgrades.tags` (object)
    Node tags

  - `clusterUpgrades.tags` (object)
    Cluster tags

  - `completedAt` (string)
    Upgrade completion time

  - `dryRun` (boolean)
    Whether this was a dry-run

  - `excludeTags` (object)
    Exclude devices with these tags

  - `failoverApproved` (boolean)
    True once a user has approved cluster failovers

  - `includeTags` (object)
    Include devices with these tags

  - `manualFailover` (boolean)
    Whether to require approval to failover clusters

  - `name` (string)
    Name of upgrade
    Example: "Sep27"

  - `offlineTimeout` (number)
    Minutes to wait before failing (timing out) a workflow for a node in the offline state

  - `startedAt` (string)
    Upgrade start time

  - `status` (string)
    Status of upgrade
    Enum: "active", "planning", "complete"

  - `uid` (string)
    Unique ID of upgrade
    Example: "2DqxLdknjWxEkGt474d2Cstsa1O"

  - `upgradeTimeout` (number)
    Minutes to wait before failing (timing out) a workflow


## Response 404 fields