Skip to Content
SeyloDocs
API referenceNodes

Get a node

GET
/api/v1/nodes.get

Returns one node with its capabilities, log retention, desired-state revisions and the services placed on it.

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

Authorization

cookieseylo_session<token>

Query Parameters

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}$
name*string

Lowercase letters, digits, dots and hyphens; unique.

Match^[a-z0-9][a-z0-9.-]*$
Length1 <= length <= 60
location*|null
tags*array<>
status*string|string|string
isPanelNode*boolean
publicIpv4*string|null
publicIpv6*string|null
publicAddress*string|null
wildcardDomain*string|null
agentVersion*string|null
updateAvailable*boolean
canBuild*boolean
canBuildWarning*string|null
maxParallelBuilds*integer
Range1 <= value <= 16
wings*
gamesFirstCpu*boolean
facts*|null
usage*|null
serviceCount*integer
Range0 <= value
health*
lastSeenAt*|null
createdAt*string
Formatdate-time
updatedAt*string
Formatdate-time
capabilities*array<string>
logRetention*
services*array<>
desiredRevision*integer
Range0 <= value
appliedRevision*|null
panelAddress*string|null
Example Request
curl -X GET 'https://example.com/api/v1/nodes.get?nodeId=string'
Example Response
{  "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",  "capabilities": [    "string"  ],  "logRetention": {    "maxBytesPerService": 1048576,    "maxAgeDays": 1  },  "services": [    {      "serviceId": "string",      "serviceName": "string",      "projectId": "string",      "projectName": "string",      "replicas": 0,      "phase": "pending"    }  ],  "desiredRevision": 0,  "appliedRevision": 0,  "panelAddress": "string"}

Create a join token POST

Creates a single-use token that lets a new server join this panel within one hour, and the install command to run on it as root. From a browser session it needs a sign-in or auth.reauth from the last 15 minutes (FORBIDDEN details.reason "reauth" otherwise); API keys need none. Needs `nodes.manage`, which owners and admins hold. Not available to MCP clients or the assistant.

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.