Skip to Content
SeyloDocs
API referenceNodes

Change node settings

POST
/api/v1/nodes.updateSettings

Changes a node's location label, public address, wildcard domain, how many builds run at once and how much log history each service keeps. Omitted fields stay as they are.

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}$
location?|null
publicAddress?|null
wildcardDomain?|null
maxParallelBuilds?integer
Range1 <= value <= 16
logRetention?

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 POST 'https://example.com/api/v1/nodes.updateSettings' \  -H 'Content-Type: application/json' \  -d '{  "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"}

Update Docker on a node POST

Upgrades Docker Engine with the distribution's package manager. Running containers restart with the daemon. With dryRun it only reports the versions. Needs `nodes.manage`, which owners and admins hold. Available to MCP clients and the assistant.

List notification channels GET

Lists every notification channel with a redacted target, which services use it and its last delivery. Secrets are never returned. Any signed-in caller. Available to MCP clients and the assistant.