Skip to Content
SeyloDocs
API referenceUpdates

Update one node

POST
/api/v1/updates.updateNode

Updates one node's agent to the panel's version. The agent swaps its binary, reconnects, and rolls back by itself if the new one fails.

Needs updates.manage, which owners and admins hold. Available to MCP clients and the assistant.

Authorization

cookieseylo_session<token>

Request Body

application/json
  1. body
nodeId*string

Panel-issued id.

Match^[a-z0-9]{16}$

Response Body

Success.

application/json
  1. response
id*string

Panel-issued id.

Match^[a-z0-9]{16}$
targetVersion*string
trigger*string|string
status*string|string|string|string
startedBy*|null
error*string|null
createdAt*string
Formatdate-time
finishedAt*|null
doneSteps*integer
Range0 <= value
totalSteps*integer
Range0 <= value
steps*array<>
Example Request
curl -X POST 'https://example.com/api/v1/updates.updateNode' \  -H 'Content-Type: application/json' \  -d '{  "nodeId": "string"}'
Example Response
{  "id": "string",  "targetVersion": "string",  "trigger": "auto",  "status": "running",  "startedBy": "string",  "error": "string",  "createdAt": "2019-08-24T14:15:22Z",  "finishedAt": "2019-08-24T14:15:22Z",  "doneSteps": 0,  "totalSteps": 0,  "steps": [    {      "id": "string",      "position": 0,      "target": "panel",      "nodeId": "string",      "nodeName": "string",      "fromVersion": "string",      "toVersion": "string",      "status": "pending",      "error": "string",      "startedAt": "2019-08-24T14:15:22Z",      "finishedAt": "2019-08-24T14:15:22Z"    }  ]}

Get update status GET

Returns the panel's and every node's version, the newest release, whether auto-update is on, and the update run in progress. Needs `nodes.view`, which owners and admins hold. Available to MCP clients and the assistant.

Update the panel POST

Starts an update run to the newest release: the panel first (a few seconds of an updating page, apps keep running), then, unless panelOnly is set, every node one at a time. Fails with CONFLICT while another run is active. Needs `updates.manage`, which owners and admins hold. Available to MCP clients and the assistant.