Skip to Content
SeyloDocs
API referenceCompose stacks

Change a compose stack's file

POST
/api/v1/compose.update

Replaces a stack's compose file. With dryRun the result is the member diff (create, update, delete) and nothing changes; without it members are created, updated or deleted to match, and changed members are deployed.

Needs services.update 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}$
source*||
dryRun?boolean
Defaultfalse

Response Body

Success.

application/json
  1. response
members*array<>
warnings*array<string>
Example Request
curl -X POST 'https://example.com/api/v1/compose.update' \  -H 'Content-Type: application/json' \  -d '{  "serviceId": "string",  "source": {    "type": "inline",    "yaml": "string"  }}'
Example Response
{  "members": [    {      "composeService": "string",      "name": "string",      "action": "create",      "image": "string",      "ports": [        1      ],      "volumes": [        {          "name": "string",          "mountPath": "string",          "sharedWith": [            "string"          ]        }      ],      "dependsOn": [        "string"      ],      "envKeys": [        "string"      ],      "hasHealthCheck": true    }  ],  "warnings": [    "string"  ]}