Skip to Content
SeyloDocs
API referenceBoxes

Stop a Box

POST
/api/v1/boxes.stop

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.

Authorization

cookieseylo_session<token>

Request Body

application/json
  1. body
serviceId*string

Panel-issued id.

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

Response Body

Success.

application/json
  1. response
serviceId*string

Panel-issued id.

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

Panel-issued id.

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

DNS-safe; the service's host name on the project network. Unique in its project.

Match^[a-z0-9]([a-z0-9-]*[a-z0-9])?$
Length1 <= length <= 40
nodeId*string

Panel-issued id.

Match^[a-z0-9]{16}$
nodeName*string
state*string|string|string|string
repository*string|null
idleMinutes*integer
Range0 <= value <= 1440
lastUsedAt*|null
createdAt*string
Formatdate-time
Example Request
curl -X POST 'https://example.com/api/v1/boxes.stop' \  -H 'Content-Type: application/json' \  -d '{  "serviceId": "string"}'
Example Response
{  "serviceId": "string",  "projectId": "string",  "name": "string",  "nodeId": "string",  "nodeName": "string",  "state": "running",  "repository": "string",  "idleMinutes": 0,  "lastUsedAt": "2019-08-24T14:15:22Z",  "createdAt": "2019-08-24T14:15:22Z"}

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.

Get a service's build settings GET

Returns how a service is built (builder, paths, inline Dockerfile, command overrides, build node) and the nodes it could build on, with whether each can build. Needs `services.view` on the service (a grant on its project covers it). Available to MCP clients and the assistant.