Skip to Content
SeyloDocs
API referenceNodes

List nodes

GET
/api/v1/nodes.list

Lists every node with its status, latest usage, version, build and Wings settings, sorted with the panel node first.

Needs nodes.view, which owners and admins hold. Available to MCP clients and the assistant.

Authorization

cookieseylo_session<token>

Response Body

Success.

application/json
  1. response
nodes*array<>
Example Request
curl -X GET 'https://example.com/api/v1/nodes.list'
Example Response
{  "nodes": [    {      "id": "string",      "name": "string",      "location": "string",      "tags": [        "string"      ],      "status": "online",      "isPanelNode": true,      "publicIpv4": "string",      "publicIpv6": "string",      "publicAddress": "string",      "wildcardDomain": "string",      "agentVersion": "string",      "updateAvailable": true,      "canBuild": true,      "canBuildWarning": "string",      "maxParallelBuilds": 1,      "wings": {        "detected": true,        "version": "string",        "sharedProxy": true      },      "gamesFirstCpu": true,      "facts": {        "hostname": "string",        "os": "string",        "kernel": "string",        "arch": "string",        "cpuCores": 0,        "memoryTotalBytes": 0,        "diskTotalBytes": 0,        "diskFreeBytes": 0,        "dockerVersion": "string",        "cgroupVersion": 0,        "bootTime": "2019-08-24T14:15:22Z"      },      "usage": {        "at": "2019-08-24T14:15:22Z",        "cpuPercent": 0,        "memoryUsedBytes": 0,        "memoryTotalBytes": 0,        "diskUsedBytes": 0,        "diskTotalBytes": 0,        "networkRxBytesPerSec": 0,        "networkTxBytesPerSec": 0,        "load1": 0      },      "serviceCount": 0,      "health": {        "checkedAt": "2019-08-24T14:15:22Z",        "worst": "pass"      },      "lastSeenAt": "2019-08-24T14:15:22Z",      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z"    }  ]}

Get the last health check report GET

Returns the last stored health check report of a node without running the checks again. Needs `nodes.view`, which owners and admins hold. Available to MCP clients and the assistant.

List open join tokens GET

Lists join tokens that are neither used nor expired, newest first. The token values themselves are never shown again. Needs `nodes.manage`, which owners and admins hold. Not available to MCP clients or the assistant.