Skip to Content
SeyloDocs
API referenceNodes

Create a join token

POST
/api/v1/nodes.createJoinToken

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.

Authorization

cookieseylo_session<token>

Request Body

application/json
  1. body

Response Body

Success.

application/json
  1. response
tokenId*string

Panel-issued id.

Match^[a-z0-9]{16}$
token*string
command*string
expiresAt*string
Formatdate-time
insecureTransport*boolean
Example Request
curl -X POST 'https://example.com/api/v1/nodes.createJoinToken' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "tokenId": "string",  "token": "string",  "command": "string",  "expiresAt": "2019-08-24T14:15:22Z",  "insecureTransport": true}

Read the agent's own log GET

Returns the newest lines of the node agent's own log (its systemd journal), oldest first, with secrets redacted. Needs the node to be online. Needs `nodes.manage`, which owners and admins hold. Available to MCP clients and the assistant.

Get a node 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.