Skip to Content
SeyloDocs
API referenceUpdates

Update the panel

POST
/api/v1/updates.updatePanel

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.

Authorization

cookieseylo_session<token>

Request Body

application/json
  1. body
panelOnly?boolean
Defaultfalse

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.updatePanel' \  -H 'Content-Type: application/json' \  -d '{}'
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"    }  ]}

Update one node POST

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.

Create an uptime check POST

Adds an uptime check to a service. The first request runs right away. Needs `services.alerts` on the service (a grant on its project covers it). Available to MCP clients and the assistant.