Skip to Content
SeyloDocs
API referenceNodes

Remove a node

POST
/api/v1/nodes.remove

Removes a node from the panel and forgets its key. Fails while services are placed on it, and for the node that runs the panel. Containers on the machine are not touched. The caller repeats the node name to confirm.

Needs nodes.manage, which owners and admins hold. Available to MCP clients and the assistant, after a person approves the call.

Authorization

cookieseylo_session<token>

Request Body

application/json
  1. body
nodeId*string

Panel-issued id.

Match^[a-z0-9]{16}$
confirmName*string

Must equal the node's name.

Response Body

Success.

application/json
  1. response
Example Request
curl -X POST 'https://example.com/api/v1/nodes.remove' \  -H 'Content-Type: application/json' \  -d '{  "nodeId": "string",  "confirmName": "string"}'
Example Response
{}

Reboot a node POST

Reboots the machine after a few seconds. Every service on it is down until the machine and Docker are back; the agent reconnects by itself. The caller repeats the node name to confirm. Needs `nodes.manage`, which owners and admins hold. Available to MCP clients and the assistant.

Rename a node POST

Changes a node's name. Services, domains and the agent are not affected. Needs `nodes.manage`, which owners and admins hold. Available to MCP clients and the assistant.