STstudio-saelix
Stacks

Update or rebuild one Compose service

Changed on

Manually pulls or builds one declared service, then recreates only that service with --no-deps --force-recreate. Multi-service stacks only. Requires stack:deploy. Automation paths continue to update the full stack.

A service whose io.sencho.update label is disabled is refused with 409 before any Compose call. This is the operator's own update, so manual and an unrecognized value do not block it.

post/api/stacks/{stackName}/services/{serviceName}/update

Request

  • Base URL
    https://localhost:1852
  • URL
    https://localhost:1852/api/stacks/{stackName}/services/{serviceName}/update
  • Auth
    HTTP bearer

Path parameters

stackNamestring required
Example:my-stack

Stack directory name. Must match ^[a-zA-Z0-9_-]+$ (alphanumeric characters, hyphens, and underscores only). Returns 400 Invalid stack name if the name contains path separators, dots, spaces, or other special characters.

serviceNamestring required

Headers

x-node-idinteger
Example:1

Target a specific node by ID. If omitted, the default node is used. Can also be passed as ?nodeId= query parameter.

Response

Service update completed.

serviceNamestring required
healthGateIdstring nullable required
observingboolean required
recoveryIdstring nullable
recoveryAvailableboolean required
recheckWarningstring

Changes