Skip to Content
SeyloDocs
API referenceNodes

Run node health checks

POST
/api/v1/nodes.runHealthCheck

Runs the node health checks now (Docker, disk, clock, ports 80 and 443, DNS, proxy, Wings coexistence) and stores the report.

Needs nodes.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
nodeId*string

Panel-issued id.

Match^[a-z0-9]{16}$
checkedAt*|null
summary*
results*array<>
Example Request
curl -X POST 'https://example.com/api/v1/nodes.runHealthCheck' \  -H 'Content-Type: application/json' \  -d '{  "nodeId": "string"}'
Example Response
{  "nodeId": "string",  "checkedAt": "2019-08-24T14:15:22Z",  "summary": {    "pass": 0,    "warn": 0,    "fail": 0,    "skipped": 0  },  "results": [    {      "id": "string",      "title": "string",      "status": "pass",      "detail": "string",      "fixHint": "string"    }  ]}

Revoke a join token POST

Makes an unused join token invalid right away. Needs `nodes.manage`, which owners and admins hold. Not available to MCP clients or the assistant.

Allow or forbid builds on a node POST

Turns builds on this node on or off. Images built anywhere run on every node, so small nodes usually leave this off. Needs `nodes.manage`, which owners and admins hold. Available to MCP clients and the assistant.