Skip to Content
SeyloDocs

Delete a service

POST
/api/v1/services.delete

Deletes a service with its containers, volumes, files, domains, deploy history and kept images on every node. Deleting a compose stack deletes its members. Protected services cannot be deleted. The caller repeats the service name to confirm.

Needs services.delete on the service (a grant on its project covers it). Available to MCP clients and the assistant, after a person approves the call.

Authorization

cookieseylo_session<token>

Request Body

application/json
  1. body
serviceId*string

Panel-issued id.

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

Must equal the service's name.

Response Body

Success.

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