Skip to Content
SeyloDocs
API referenceDocker cleanup

Preview a cleanup

GET
/api/v1/cleanup.preview

Lists what a cleanup of this node would remove and how much space it frees, without removing anything.

Needs nodes.manage, which owners and admins hold. Available to MCP clients and the assistant.

Authorization

cookieseylo_session<token>

Query Parameters

nodeId*string

Panel-issued id.

Match^[a-z0-9]{16}$
images?boolean
Defaulttrue
buildCache?boolean
Defaulttrue
stoppedContainers?boolean
Defaulttrue
orphanedServiceData?boolean
Defaultfalse

Response Body

Success.

application/json
  1. response
nodeId*string

Panel-issued id.

Match^[a-z0-9]{16}$
bytes*integer
Range0 <= value
items*array<string>
Example Request
curl -X GET 'https://example.com/api/v1/cleanup.preview?nodeId=string'
Example Response
{  "nodeId": "string",  "bytes": 0,  "items": [    "string"  ]}

Roll back to a deployment POST

Deploys the image of an earlier successful deployment again, by digest, without building. Settings and environment are the current ones. Fails when the image is no longer kept. Needs `services.deploy` on the service (a grant on its project covers it). Available to MCP clients and the assistant.

Clean up a node POST

Removes unused images, build cache, stopped containers and (when asked) orphaned service data created by this panel on one node. Never touches anything else on the machine. Needs `nodes.manage`, which owners and admins hold. Available to MCP clients and the assistant, after a person approves the call.