Trigger an immediate software upgrade of the node

Request

Forces the node to run its upgrade process immediately, bypassing the normal scheduled unattended-upgrade window. If an upgrade is already in progress, returns a status message indicating so.

Requires nodes::service:node-upgrade or nodes::remote-execute permission.

Security

JWTAuthorizer

Path

nodeIDstringrequired

Node ID

Query

waitinteger

Pass 1 to block until the node responds and return its output.

Value:1

Bodyapplication/json

skipUnattendedboolean

If true, skip the unattended-upgrade step

Default:false

curl -i -X POST \
  'https://apidocs.trustgrid.io/_mock/node/{nodeID}/trigger/node-upgrade?wait=1' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "skipUnattended": false
  }'

Responses

OK

Bodyapplication/json

outputobject

Response

{
  "output": {
    "status": "Upgrade in progress"
  }
}