API referenceBoxes
Open a Box
POST
Returns a one-time link that signs the caller in to the Box's editor; the Box wakes up if it was sleeping or stopped.
Needs boxes.use on the service (a grant on its project covers it). Not available to MCP clients or the assistant.
cookie
seylo_session<token>application/json- body
serviceId*stringPanel-issued id.
Match
^[a-z0-9]{16}$Success.
application/json- response
url*stringexpiresAt*stringFormat
date-timecurl -X POST 'https://example.com/api/v1/boxes.open' \ -H 'Content-Type: application/json' \ -d '{ "serviceId": "string"}'Example Response
{ "url": "string", "expiresAt": "2019-08-24T14:15:22Z"}Get a Box GET
Returns a Box's node, state (running, starting, sleeping, stopped) and idle settings. Needs `services.view` on the service (a grant on its project covers it). Available to MCP clients and the assistant.
Stop a Box POST
Stops a Box now. Files in its home volume stay; opening it again starts it. Needs `boxes.use` on the service (a grant on its project covers it). Available to MCP clients and the assistant.